分页查询当前主账号名下的 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。请求参数 |
|
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 （可选）按构建状态筛选。未知值不筛选。可选值：
| |
mode integer （可选）无需传入。列表已按 Acting 模型过滤，items[].mode 恒为 3。若仍传入且非 3 返回 400000。 |
响应参数 | 查询成功 |
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=[]和对应分页信息。