3D
3D 모델 상태 가져오기
3D 생성 작업의 상태 및 결과를 가져옵니다
GET /v1/3d/generations/{id}는 호환성 엔드포인트입니다. 기존 통합을 위해 계속 지원됩니다. 새로운 통합은 GET /v1/tasks/{id}를 폴링(poll)해야 합니다. 작업 상태 가져오기를 참조하세요.
GET /v1/tasks/{id}를 호출하여 3D 모델 생성 작업의 상태를 확인합니다.
id와 task_id는 동일한 작업을 식별합니다.
만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키로 작업 소유권을 확인할 수 없는 경우, 응답은 403 task_not_owned입니다.
경로 매개변수 (Path Parameters)
3D 생성 작업 ID입니다.
응답 (Response)
결과, 오류, 타임스탬프 및 모델을 설명하는 필드는 작업에 대해 사용 가능한 경우 반환됩니다.
작업 ID입니다.
제공된 경우의 비동기 작업 식별자 별칭입니다.
이 작업에 대한 상태 URL입니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하세요.
작업 상태: pending, processing, completed, failed 또는 timeout. 실패한 작업도 HTTP 200을 반환합니다.
선택적 진행률 값입니다. 실제 진행률 값을 사용할 수 있는 경우에만 반환됩니다. 완료 여부를 확인하려면 status를 사용하세요.
3D 모델 파일을 다운로드할 수 있는 URL입니다(완료 시). 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.
GLB 형식 모델을 다운로드할 수 있는 URL입니다(사용 가능한 경우).
FBX 형식 모델을 다운로드할 수 있는 URL입니다(사용 가능한 경우).
오류 메시지입니다(실패 시).
작업 실패 시의 상세 정보: status, message, type, code, retryable, 그리고 요청 필드에 문제가 있는 경우 param이 포함됩니다.
결과 링크의 저장 상태: days 및 url, kind, status, expires_at을 포함하는 items[]입니다. 이 필드는 없을 수 있으며, 링크는 여전히 작동합니다. 데이터 보존을 참조하세요.
요청
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"응답
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"glb_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"fbx_url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"kind": "3d",
"content_type": "model/gltf-binary",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
},
{
"url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"kind": "3d",
"content_type": "application/octet-stream",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.
응답
application/json
application/json
application/json
application/json
application/json
application/json
application/json