Worlds
월드 상태 가져오기
World Labs Marble 월드 생성 작업의 상태 및 결과를 조회합니다.
이 엔드포인트를 폴링(poll)하여 World Labs Marble 생성 작업의 상태를 확인하십시오. 생성 응답에 poll_url이 포함되어 있다면, 해당 URL을 직접 호출하는 것을 권장합니다.
만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키로 작업 소유권을 확인할 수 없는 경우 403 task_not_owned 응답이 반환됩니다.
경로 매개변수 (Path Parameters)
월드 생성 작업 ID입니다.
응답 (Response)
성공적인 상태 응답에는 id와 status만 필수 항목입니다. 작업 별칭(alias), 작업 ID, 월드 에셋, 캡션, 비용 및 error 문자열은 사용 가능한 경우에만 반환됩니다. 작업이 완료되었다고 해서 모든 에셋 URL이 존재하는 것은 아닙니다.
공개 작업 ID입니다.
비동기 작업 식별자 별칭입니다.
World Labs 작업 ID입니다.
작업 상태: pending, processing, completed, failed 또는 timeout.
완료 시 World Labs 월드 ID입니다.
완료 시 생성된 Marble 월드 URL입니다.
기본 생성 월드/모델 URL의 별칭입니다.
사용 가능한 경우의 콜라이더 메시(Collider mesh) GLB URL입니다.
사용 가능한 경우의 파노라마 이미지 URL입니다.
사용 가능한 경우의 썸네일 이미지 URL입니다.
생성된 월드에 대한 캡션입니다.
total_credits를 포함하여 사용 가능한 경우의 생성 비용 세부 정보입니다. 청구 금액은 사용 기록을 확인하십시오.
작업 실패 시의 오류 메시지입니다.
요청
curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/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", "cost": {}, "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" } }}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
월드 생성 작업 ID입니다.
응답
application/json
application/json
application/json