Paginate through the Acting Worlds under the current primary account. The endpoint is automatically isolated by model and never returns Directing or Adventure Worlds.
Scope
Paginate through the Acting Worlds under the current primary account. Before calling, confirm the following:
-
Authentication: Only the primary API Key is supported; temporary API Keys cannot be used (error code
403003).- Get the primary API Key: Get and configure an API Key.
- Caller: Called by your server.
HTTP request
- Singapore
- US (Virginia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worldsReplace {WorkspaceId} with your actual Workspace ID.Request parameters |
|
Authorization string (Required)API Key authentication. Only the primary API Key is supported; it starts with sk-, e.g. sk-xxx. It is typically configured as the environment variable $DASHSCOPE_API_KEY. A temporary API Key (starting with st-) returns 403003. | |
Query parameters | |
page integer (Optional)Page number, defaults to 1. When page <= 0 it is treated as 1. | |
pageSize integer (Optional)Items per page, defaults to 20. When pageSize <= 0 it is treated as 20; when greater than 100 it is capped at 100. | |
status string (Optional)Filter by build status. Unknown values are not applied as a filter. Allowed values:
| |
mode integer (Optional)No need to pass this. The list is already filtered to the Acting model, and items[].mode is always 3. If you still pass it and the value is not 3, 400000 is returned. |
Response parameters | Query succeeded |
code integerReturn code. 0 means success; non-zero is an error code. | |
message stringError message. null on success. | |
data objectResponse data. null on failure.
Properties items arrayThe Worlds on the current page; an empty array when there is no result. Each item contains encryptedWorldId, name, status (generating / ready / failed), mode (always 3), previewUrl (usually null), createdAt, perspective (usually null), creationModel (always simple), and uploadMode (fixed to first_frame).pagination objectPagination info. Contains page (current page number), pageSize (actual items per page), total (total number of records), and hasMore (true when page × pageSize < total). |
Prerequisite states and call notes
- Model filtering takes effect automatically; the list never mixes in Worlds from other models, and
items[].modeis always3. - List items are lightweight snapshots; they do not return images, prompts,
resolution,aspectRatio, orrefWorldId. When you need the full configuration, call Query World Detail. - When paging, use
pagination.pageSizeandhasMorefrom the response; do not assume the requested values are adopted verbatim. - An empty result is not an error; it returns
items=[]and the corresponding pagination info.
Error codes
If the model call fails and returns an error, see HappyOyster Error Codes to resolve it.
Next steps
- Query World Detail: view the full metadata of a single World.
- Delete World: delete a World you no longer use.