すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:HappyOyster-Acting-Query World Detail APIリファレンス

    ドキュメントセンター

    Alibaba Cloud Model Studio:HappyOyster-Acting-Query World Detail APIリファレンス

    最終更新日:Sep 23, 2026

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

    スコープ

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

    • 認証：プライマリ API Key のみがサポートされています。一時的な API Key は使用できません（エラーコード 403003）。

    • 前提条件：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-acting/openapi/v1/worlds/detail

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

    米国（バージニア）

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

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

    リクエストパラメーター

    World詳細のクエリ

    curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/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 （必須）

    現在のプライマリアカウント配下のActing暗号化World ID。Create Worldによって返されます。

    レスポンスパラメーター 

    {
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "name": "Late-Night Video Call",
        "status": "ready",
        "mode": 3,
        "creationModel": "simple",
        "prompt": "During a late-night video call, a quiet girl smiles back at the camera",
        "eventStyle": "first_frame",
        "perspective": null,
        "uploadMode": "first_frame",
        "resolution": "480p",
        "aspectRatio": "9:16",
        "layout": null,
        "narrative": null,
        "refWorldId": null,
        "firstFrameImage": {
            "url": "https://cdn.happyoyster.com/frames/portrait-call.jpg",
            "referenceType": "default"
        },
        "inputImages": null,
        "sceneImage": null,
        "roleImage": null,
        "scenePrompt": null,
        "rolePrompt": null,
        "scriptList": null,
        "previewUrl": null,
        "createdAt": "2026-09-09T08:00:00Z",
        "updatedAt": "2026-09-09T08: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

    Acting では常に 3 です。

    creationModel string

    Acting では常に simple です。

    prompt string

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

    eventStyle string

    互換性のために返されるフィールドです。準拠した作成でこのフィールドが省略された場合、サーバーは通常uploadModeからマッピングし、first_frameをエコーします。これはActingの作成パラメータではないため、クライアントはこれを返信しないでください。

    perspective null

    Actingはperspective作成パラメータを受け付けません。nullに固定されています。

    uploadMode string

    first_frameに固定されています。

    resolution string

    480p / 720p。作成時に指定されない場合は480pとなります。

    aspectRatio string

    9:16 / 16:9。作成時に指定されない場合は9:16となります。

    layout null

    Actingはこの作成パラメータを受け付けません。nullに固定されています。

    narrative null

    Actingはこの作成パラメータを受け付けません。nullに固定されています。

    refWorldId string

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

    firstFrameImage object

    作成時に必須の初回フレーム画像。URL形式でのみ返され、base64は返されません。urlおよびreferenceTypeを含みます。

    inputImages null

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

    sceneImage null

    Actingはシーン/ロール画像スロットを使用しません。nullに固定されています。

    roleImage null

    Actingはシーン/ロール画像スロットを使用しません。nullに固定されています。

    scenePrompt null

    Actingはシーン/ロールプロンプトを使用しません。nullに固定されています。

    rolePrompt null

    Actingはシーン/ロールプロンプトを使用しません。nullに固定されています。

    scriptList null

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

    previewUrl null

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

    createdAt string

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

    updatedAt string

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

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

    • このエンドポイントはgenerating、ready、またはfailed状態のWorldをクエリできます。準備が整う前のビルド成果物はnullとなる場合があります。
    • 詳細エンドポイントはasyncをエコーしません。これはWorldの属性ではなく、呼び出し動作の切り替えであるためです。
    • 画像はURLおよびreferenceTypeとしてのみ返されます。作成リクエスト内のbase64コンテンツは返されません。
    • eventStyleは通常uploadModeと同じ値になります。クライアントはActing作成モードの信頼できるフィールドとしてuploadModeを扱う必要があります。
    • プレーヤーはaspectRatioを事前読み込みできますが、実際にルームに入る際は、Enter Travelのレスポンス値から向きを設定する必要があります。
    • 別のモデル、別のプライマリアカウント、または削除済みのWorldをクエリした場合、いずれも403001が返され、リソースが存在するかどうかは開示されません。

    エラーコード

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

    次のステップ