3D
3D 모델 생성
3D 모델 생성 작업을 생성합니다
Tripo3D 및 기타 제공업체를 사용하여 텍스트 또는 이미지에서 3D 모델을 생성합니다. 이 API는 비동기 방식으로 동작합니다. 생성 응답은 작업 ID를 반환하며, 사용 가능할 때는 우선 사용해야 하는 poll_url 도 함께 반환할 수 있습니다.
공개 3D operation은 요청 형태에서 추론됩니다. prompt만 있는 요청은 text-to-3d, image 또는 image_url이 있는 요청은 image-to-3d로 처리됩니다. 이 endpoint는 operation 요청 필드를 노출하지 않으므로 legacy 3d-generation 값을 보내지 마십시오.
요청 본문
선택 필드를 보내기 전에 GET /v1/models/{model}에서 모델이 허용하는 매개변수를 확인하세요. 예제는 model과 prompt만 보냅니다.
tripo-h3.1사용할 모델입니다. 예: tripo-h3.1 또는 tripo-p1.0. 특정 입력 유형이나 출력 형식에 의존하기 전에 GET /v1/models?recommended_for=3d를 확인하세요.
생성할 3D 모델에 대한 텍스트 설명입니다.
image-to-3D 생성을 위한 Base64 인코딩된 이미지입니다.
image-to-3D 생성을 위한 이미지 URL입니다.
출력 형식입니다. 지원 여부와 허용 값은 선택한 모델에 따라 다릅니다.
품질 설정입니다. 지원 여부와 허용 값은 선택한 모델에 따라 다릅니다.
모델의 스타일 프리셋입니다.
선택한 모델이 지원할 때 사용하는 정수 시드입니다.
최종 사용자를 위한 고유 식별자입니다.
응답
상태 폴링을 위한 작업 ID입니다.
어댑터가 반환하는 경우의 비동기 작업 ID 별칭입니다.
사용 가능할 때 반환되는 우선 폴링 URL입니다.
작업 상태: pending, processing, completed 또는 failed.
작업이 생성된 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": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'응답
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.
허용 값
- "auto"
- "verified"
- "official"
요청 본문
application/json
응답
application/json
application/json