TokenLab

Worlds

월드 상태 가져오기

World Labs Marble 월드 생성 작업의 상태 및 결과를 가져옵니다

GET
/v1/worlds/generations/{id}

GET /v1/worlds/generations/{id}는 호환성 엔드포인트입니다. 기존 통합을 위해 계속 지원됩니다. 새로운 통합은 동일한 작업 id를 사용하여 GET /v1/tasks/{id}를 폴링해야 합니다. 작업 상태 가져오기를 참조하세요.

이 엔드포인트는 World Labs Marble 생성 작업의 상태를 반환합니다. 생성 응답에서 받은 작업 id를 사용하세요.

만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키로 작업 소유권을 확인할 수 없는 경우 응답은 403 task_not_owned입니다.

경로 매개변수

idstringpath필수

월드 생성 작업 ID.

응답

성공적인 상태 응답에는 id와 status만 필수입니다. 작업 별칭, 작업 ID, 월드 에셋 및 캡션은 사용 가능한 경우 반환됩니다. 작업이 완료되었다고 해서 모든 에셋 URL이 존재하는 것은 아닙니다. 실패한 작업도 HTTP 200을 반환하므로 status, error, error_details를 확인해야 합니다.

world_marble_url은 대화형 World Labs 뷰어를 엽니다. glb_url, pano_url, thumbnail_url과 같은 결과 파일은 TokenLab 링크이며, 작업이 완료될 때까지 비어 있거나 존재하지 않습니다.

idstring

공개 작업 ID.

task_idstring

비동기 작업 식별자 별칭.

operation_idstring

World Labs 작업 ID.

statusstring

작업 상태: pending, processing, completed, failed 또는 timeout.

world_idstring

완료 시 World Labs 월드 ID.

world_marble_urlstring

완료 시 생성된 Marble 월드에 대한 URL.

model_urlstring

기본 생성 월드/모델 URL의 별칭.

glb_urlstring

사용 가능한 경우의 콜라이더 메시 GLB URL. 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.

pano_urlstring

사용 가능한 경우의 파노라마 이미지 URL. 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.

thumbnail_urlstring

사용 가능한 경우의 썸네일 이미지 URL. 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.

captionstring

생성된 월드에 대한 캡션.

errorstring | object

작업 실패 시의 오류 메시지.

error_detailsobject

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

media_retentionobject

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

요청

curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
{  "id": "string",  "task_id": "string",  "operation_id": "string",  "status": "pending",  "world_id": "string",  "world_marble_url": "string",  "model_url": "string",  "glb_url": "string",  "pano_url": "string",  "thumbnail_url": "string",  "caption": "string",  "error": "string",  "error_details": {    "projection_version": 0,    "status": 400,    "message": "string",    "type": "string",    "code": "string",    "param": "string",    "retryable": true,    "upstream": {      "source": "string",      "code": "string",      "message": "string",      "param": "string"    }  },  "media_retention": {    "days": 0,    "items": [      {        "url": "http://example.com",        "kind": "image",        "content_type": "string",        "status": "saving",        "expires_at": "2019-08-24T14:15:22Z"      }    ]  }}

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

경로 매개변수

id*string

월드 생성 작업 ID입니다.

응답

application/json

application/json

application/json