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

現在のプライマリアカウント配下のActing Worldをページネーションで取得します。このエンドポイントはモデルごとに自動的に分離されており、DirectingやAdventureのWorldを返すことはありません。

スコープ

現在のプライマリアカウント配下のActing Worldをページネーションで取得します。呼び出し前に以下を確認してください：

認証：プライマリ API Key のみがサポートされています。一時的な API Key は使用できません（エラーコード 403003）。
- プライマリ API Key を取得する：API Key の取得と設定。
Caller：サーバーから呼び出されます。

HTTP リクエスト

Singapore

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

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

米国（バージニア）

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

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

リクエストパラメーター

Worldリストのクエリ

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds?page=1&pageSize=20&status=ready' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Authorization string （必須）

API Key 認証。プライマリ API Key のみがサポートされており、sk- で始まります（例：sk-xxx）。通常、環境変数 $DASHSCOPE_API_KEY として設定されます。一時的な API Key（st- で始まる）を使用すると 403003 が返されます。

クエリパラメータ

page integer （任意）

ページ番号です。デフォルトは1です。page <= 0の場合は1として扱われます。

pageSize integer （任意）

ページあたりの項目数で、デフォルトは20です。pageSize <= 0の場合は20として扱われ、100を超える場合は100に制限されます。

status string （任意）

ビルドステータスでフィルタリングします。不明な値はフィルタとして適用されません。許可される値：

generating: 構築中
ready: 準備完了
failed: 構築失敗

mode integer (任意)

これを渡す必要はありません。リストはすでにActingモデルにフィルタリングされており、items[].modeは常に3です。それでも渡し、かつ値が3でない場合、400000が返されます。

レスポンスパラメーター

{
    "code": 0,
    "message": null,
    "data": {
        "items": [
            {
                "encryptedWorldId": "enc_a1b2****",
                "name": "Late-Night Video Call",
                "status": "ready",
                "mode": 3,
                "previewUrl": null,
                "createdAt": "2026-09-09T08:00:00Z",
                "perspective": null,
                "creationModel": "simple",
                "uploadMode": "first_frame"
            },
            {
                "encryptedWorldId": "enc_g7h8****",
                "name": "Relaxed Living Room Chat",
                "status": "ready",
                "mode": 3,
                "previewUrl": null,
                "createdAt": "2026-09-09T09:00:00Z",
                "perspective": null,
                "creationModel": "simple",
                "uploadMode": "first_frame"
            }
        ],
        "pagination": {
            "page": 1,
            "pageSize": 20,
            "total": 2,
            "hasMore": false
        }
    }
}

code integer

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

message string

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

data object

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

プロパティ

items array

現在のページのWorld一覧。結果がない場合は空の配列となります。各項目には、encryptedWorldId、name、status（generating / ready / failed）、mode（常に3）、previewUrl（通常null）、createdAt、perspective（通常null）、creationModel（常にsimple）、およびuploadMode（first_frameに固定）が含まれます。

pagination object

ページネーション情報です。page（現在のページ番号）、pageSize（実際の1ページあたりの項目数）、total（総レコード数）、および hasMore（page × pageSize < total の場合は true）が含まれます。

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

モデルフィルタリングは自動的に有効になります。リストに他のモデルのWorldが混在することはなく、items[].modeは常に3となります。
リスト項目は軽量スナップショットです。画像、プロンプト、resolution、aspectRatio、またはrefWorldIdは返されません。完全な設定が必要な場合は、Query World Detailを呼び出してください。
ページネーションの際は、レスポンスのpagination.pageSizeおよびhasMoreを使用してください。リクエストした値がそのまま採用されるとは限りません。
空の結果はエラーではありません。items=[]と対応するページネーション情報が返されます。

エラーコード

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

次のステップ

Query World Detail：単一Worldの完全なメタデータを表示します。
Delete World：不要になったWorldを削除します。