Worlds
ワールドステータスの取得
World Labs Marbleのワールド生成タスクのステータスと結果を取得します
このエンドポイントをポーリングして、World Labs Marble生成タスクのステータスを確認します。作成時のレスポンスに poll_url が含まれている場合は、そのURLを直接呼び出すことを推奨します。
期限切れまたは利用不可能なパブリックタスクは、404 async_task_not_found を返す場合があります。現在のAPIキーでタスクの所有権が確認できない場合、レスポンスは 403 task_not_owned となります。
パスパラメータ
ワールド生成タスクID。
レスポンス
ステータス取得が成功した場合、id と status のみが必須となります。タスクエイリアス、オペレーションID、ワールドアセット、キャプション、コスト、および error 文字列は、利用可能な場合に返されます。タスクが完了していても、すべてのアセットURLが存在するとは限りません。
パブリックタスクID。
非同期タスク識別子のエイリアス。
World LabsオペレーションID。
タスクステータス: pending、processing、completed、failed、または timeout。
完了時のWorld LabsワールドID。
完了時に生成されたMarbleワールドのURL。
生成された主要なワールド/モデルURLのエイリアス。
利用可能な場合のコライダーメッシュ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