메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

Tripo3D 및 기타 제공업체를 사용하여 텍스트 또는 이미지에서 3D 모델을 생성합니다. 이 API는 비동기 방식으로 동작합니다. 생성 응답은 작업 ID를 반환하며, 사용 가능할 때는 우선 사용해야 하는 poll_url 도 함께 반환할 수 있습니다.

​
요청 본문

​
model
string
기본값:"tripo3d-v2.5"
사용할 모델 (예: tripo3d-v2.5, tripo3d-v2).
​
prompt
string
필수
생성할 3D 모델에 대한 텍스트 설명입니다.
​
image
string
image-to-3D 생성을 위한 Base64 인코딩된 이미지입니다.
​
image_url
string
image-to-3D 생성을 위한 이미지 URL입니다.
​
format
string
기본값:"glb"
출력 형식: glb, fbx, obj 또는 usdz.
​
quality
string
기본값:"standard"
품질 수준: draft, standard 또는 high.
​
style
string
모델의 스타일 프리셋입니다.
​
seed
integer
재현 가능한 생성을 위한 시드(Seed) 값입니다.
​
user
string
최종 사용자를 위한 고유 식별자입니다.

​
응답

​
id
string
상태 폴링을 위한 작업 ID입니다.
​
task_id
string
어댑터가 반환하는 경우의 비동기 작업 ID 별칭입니다.
​
poll_url
string
사용 가능할 때 반환되는 우선 폴링 URL입니다.
​
status
string
작업 상태: pending, processing, completed 또는 failed.
​
created
integer
작업이 생성된 Unix 타임스탬프입니다.
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo3d-v2.5",
    "prompt": "A detailed medieval castle with towers",
    "format": "glb",
    "quality": "high"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo3d-v2.5"
}