HappyOyster-Acting-查詢 World 列表 API 參考 - Alibaba Cloud Model Studio

分頁查詢目前主帳號名下的 Acting World。介面自動按模型隔離，不會返回 Directing 或 Adventure World。

適用範圍

分頁查詢目前主帳號名下的 Acting World。呼叫前請確認以下事項：

驗證要求：僅支援 主 API Key 呼叫，臨時 API Key 無法使用（錯誤碼 403003）。
- 取得主 API Key：取得與設定 API Key。
呼叫方：您的伺服器端呼叫。

HTTP 呼叫

新加坡

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

呼叫時請將 {WorkspaceId} 替換為真實的 Workspace ID。

美国（維吉尼亞）

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

呼叫時請將 {WorkspaceId} 替換為真實的 Workspace 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。

Query 參數

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": "深夜视频通话",
                "status": "ready",
                "mode": 3,
                "previewUrl": null,
                "createdAt": "2026-09-09T08:00:00Z",
                "perspective": null,
                "creationModel": "simple",
                "uploadMode": "first_frame"
            },
            {
                "encryptedWorldId": "enc_g7h8****",
                "name": "客厅轻松对谈",
                "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 表示成功，非 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（實際每頁筆數）、total（總記錄數）、hasMore（page × pageSize < total 時為 true）。

前置狀態與呼叫注意事項

模型過濾自動生效，列表不會混入其它模型的 World，且 items[].mode 恆為 3。
列表項目是輕量快照，不返回圖片、Prompt、resolution、aspectRatio 或 refWorldId；需要完整設定時呼叫查詢 World 詳情。
翻頁時應使用回應中的 pagination.pageSize 和 hasMore，不要假設請求值一定原樣採用。
空結果並非錯誤，返回 items=[] 和對應分頁資訊。

錯誤碼

如果模型呼叫失敗並返回錯誤訊息，請參閱 HappyOyster 錯誤碼進行解決。

下一步

查詢 World 詳情：檢視單個 World 完整中繼資料。
刪除 World：刪除不再使用的 World。