HappyOyster-Adventure-World詳細クエリAPIリファレンス - Alibaba Cloud Model Studio

単一のAdventure Worldの完全なメタデータおよび反映可能な作成パラメータをクエリします。ビルド進捗のポーリングには、Worldビルドステータスクエリエンドポイントを使用してください。

スコープ

単一のAdventure Worldの完全なメタデータおよび反映可能な作成パラメータをクエリします。呼び出し前に以下を確認してください:

認証：プライマリ API Key のみがサポートされています。一時的な API Key は使用できません（エラーコード 403003）。
- プライマリ API Key を取得する：API Key の取得と設定。
前提条件：Create World によって返された encryptedWorldId を使用してクエリします。構築進捗のポーリングには Query World Build Status を使用してください。
Caller：サーバーから呼び出されます。

HTTP リクエスト

Singapore

GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/detail

{WorkspaceId} を実際のワークスペースID に置き換えます。

中国（北京）

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/detail

{WorkspaceId} を実際のワークスペースID に置き換えます。

米国（バージニア）

GET https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/detail

{WorkspaceId} を実際のワークスペースID に置き換えます。

リクエストパラメーター	World詳細のクエリ `curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/detail?encryptedWorldId={encryptedWorldId}' \ -H "Authorization: Bearer $DASHSCOPE_API_KEY"`
Authorization `string` （必須） API Key 認証。プライマリ API Key のみがサポートされており、`sk-` で始まります（例：`sk-xxx`）。通常、環境変数 `$DASHSCOPE_API_KEY` として設定されます。一時的な API Key（`st-` で始まる）を使用すると `403003` が返されます。
クエリパラメータ
encryptedWorldId `string` （必須）現在のプライマリアカウント配下のAdventure暗号化World IDです。Worldを作成によって返されます。

レスポンスパラメーター

クエリ成功

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "name": "Rainy Night Adventure in Jiangnan",
        "status": "ready",
        "mode": 1,
        "creationModel": "simple",
        "prompt": "A Jiangnan water town at dusk, with stone bridges and awning boats",
        "eventStyle": null,
        "perspective": "third_person",
        "uploadMode": "first_frame",
        "resolution": null,
        "aspectRatio": null,
        "layout": null,
        "narrative": null,
        "refWorldId": null,
        "firstFrameImage": {
            "url": "https://cdn.happyoyster.com/frames/jiangnan.jpg",
            "referenceType": "default"
        },
        "inputImages": null,
        "sceneImage": null,
        "roleImage": null,
        "scenePrompt": null,
        "rolePrompt": null,
        "scriptList": null,
        "previewUrl": null,
        "createdAt": "2026-06-03T10:00:00Z",
        "updatedAt": "2026-06-03T10:05:00Z"
    }
}

code integer

リターンコード。0 は成功を意味し、ゼロ以外の値はエラーコードです。

message string

エラーメッセージ。成功時は null です。

data object

レスポンスデータ。失敗時は null です。

プロパティ

encryptedWorldId string

暗号化されたWorld ID。

name string

World名。

status string

ビルドステータス：generating / ready / failed。

mode integer

Adventure の場合は常に 1 です。

creationModel string

Adventure の場合は常に simple です。

prompt string

作成時に送信された最上位のプロンプト。

eventStyle null

Adventureではこの作成パラメータを使用しません。通常はnullです。このフィールドはDirectingのcreationModel=simpleの場合にのみ有効です。

perspective string

視点: first_person / third_person。

uploadMode string

first_frameに固定されています。

resolution null

Adventureではこのフィールドを使用しません。通常はnullです。

aspectRatio null

Adventureではこのフィールドを使用しません。nullに固定されています。

layout null

Adventureではこのフィールドを使用しません。通常はnullです。

narrative null

Adventureではこのフィールドを使用しません。通常はnullです。

refWorldId string

派生作成に使用される暗号化された参照World ID。ない場合はnullとなります（none）。

firstFrameImage object

作成時に必須となる初回フレーム画像。URL形式でのみ返されます。urlとreferenceTypeを含みます。

inputImages null

Adventureでは現在このフィールドを使用しません。

scriptList null

AdventureはScriptListをサポートしていません。nullに固定されています。

previewUrl null

現在はnullに固定されています。

createdAt string

作成日時。ISO 8601形式です。

updatedAt string

最終更新時刻です。ISO 8601形式です。

前提条件となるステータスと呼び出しに関する注意事項

このエンドポイントはgenerating、ready、またはfailed状態のWorldをクエリできます。準備が整う前のビルド成果物はnullとなる場合があります。
詳細エンドポイントはasyncをエコーしません。これはWorldの属性ではなく、呼び出し動作の切り替えであるためです。
画像はURLおよびreferenceTypeとしてのみ返されます。作成リクエスト内のbase64コンテンツは返されません。
別のモデル、別のプライマリアカウント、または削除済みのWorldをクエリした場合、いずれも403001が返され、リソースが存在するかどうかは開示されません。

エラーコード

モデルの呼び出しに失敗してエラーが返された場合は、HappyOyster エラーコードを参照して解決してください。

次のステップ

Worldリストのクエリ: すべてのAdventure Worldをページネーションで取得します。
Delete World：不要になったWorldを削除します。
Worldがready状態の場合、Get Travel Credentialを実行できます。

スコープ

HTTP リクエスト

Singapore

中国（北京）

米国（バージニア）

リクエストパラメーター

World詳細のクエリ

クエリパラメータ

レスポンスパラメーター

クエリ成功

前提条件となるステータスと呼び出しに関する注意事項

エラーコード

次のステップ