Worlds
월드 상태 가져오기
World Labs Marble 월드 생성 작업의 상태 및 결과를 가져옵니다
GET /v1/worlds/generations/{id}는 호환성 엔드포인트입니다. 기존 통합을 위해 계속 지원됩니다. 새로운 통합은 동일한 작업 id를 사용하여 GET /v1/tasks/{id}를 폴링해야 합니다. 작업 상태 가져오기를 참조하세요.
이 엔드포인트는 World Labs Marble 생성 작업의 상태를 반환합니다. 생성 응답에서 받은 작업 id를 사용하세요.
만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키로 작업 소유권을 확인할 수 없는 경우 응답은 403 task_not_owned입니다.
경로 매개변수
월드 생성 작업 ID.
응답
성공적인 상태 응답에는 id와 status만 필수입니다. 작업 별칭, 작업 ID, 월드 에셋 및 캡션은 사용 가능한 경우 반환됩니다. 작업이 완료되었다고 해서 모든 에셋 URL이 존재하는 것은 아닙니다. 실패한 작업도 HTTP 200을 반환하므로 status, error, error_details를 확인해야 합니다.
world_marble_url은 대화형 World Labs 뷰어를 엽니다. glb_url, pano_url, thumbnail_url과 같은 결과 파일은 TokenLab 링크이며, 작업이 완료될 때까지 비어 있거나 존재하지 않습니다.
공개 작업 ID.
비동기 작업 식별자 별칭.
World Labs 작업 ID.
작업 상태: pending, processing, completed, failed 또는 timeout.
완료 시 World Labs 월드 ID.
완료 시 생성된 Marble 월드에 대한 URL.
기본 생성 월드/모델 URL의 별칭.
사용 가능한 경우의 콜라이더 메시 GLB URL. 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.
사용 가능한 경우의 파노라마 이미지 URL. 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.
사용 가능한 경우의 썸네일 이미지 URL. 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.
생성된 월드에 대한 캡션.
작업 실패 시의 오류 메시지.
작업 실패 시의 상세 정보: status, message, type, code, retryable, 그리고 요청 필드에 문제가 있는 경우의 param.
완료된 응답 내 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 API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
월드 생성 작업 ID입니다.
응답
application/json
application/json
application/json