TokenLab

3D

3D 모델 상태 가져오기

3D 생성 작업의 상태 및 결과를 가져옵니다

GET
/v1/tasks/{id}

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)

idstringpath필수

3D 생성 작업 ID입니다.

응답 (Response)

결과, 오류, 타임스탬프 및 모델을 설명하는 필드는 작업에 대해 사용 가능한 경우 반환됩니다.

idstring

작업 ID입니다.

task_idstring

제공된 경우의 비동기 작업 식별자 별칭입니다.

poll_urlstring

이 작업에 대한 상태 URL입니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하세요.

statusstring

작업 상태: pending, processing, completed, failed 또는 timeout. 실패한 작업도 HTTP 200을 반환합니다.

progressinteger

선택적 진행률 값입니다. 실제 진행률 값을 사용할 수 있는 경우에만 반환됩니다. 완료 여부를 확인하려면 status를 사용하세요.

model_urlstring

3D 모델 파일을 다운로드할 수 있는 URL입니다(완료 시). 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.

glb_urlstring

GLB 형식 모델을 다운로드할 수 있는 URL입니다(사용 가능한 경우).

fbx_urlstring

FBX 형식 모델을 다운로드할 수 있는 URL입니다(사용 가능한 경우).

errorstring | object

오류 메시지입니다(실패 시).

error_detailsobject

작업 실패 시의 상세 정보: status, message, type, code, retryable, 그리고 요청 필드에 문제가 있는 경우 param이 포함됩니다.

media_retentionobject

결과 링크의 저장 상태: days 및 url, kind, status, expires_at을 포함하는 items[]입니다. 이 필드는 없을 수 있으며, 링크는 여전히 작동합니다. 데이터 보존을 참조하세요.

요청

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

응답

Response (Completed)
{
  "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
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

경로 매개변수

id*string

id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.

응답

application/json

application/json

application/json

application/json

application/json

application/json

application/json