Skip to main content
QwenCloud home page
Docs
Acting (Invitational Preview)

HappyOyster-Acting-Query World Detail API Reference

Query the full metadata and echoable creation parameters of a single Acting World. For build-progress polling, use the Query World Build Status endpoint.

GET
/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/detail
cURL - Query World detail
curl --location 'https://dashscope-intl.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/detail?encryptedWorldId={encryptedWorldId}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "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"
  }
}

Scope

Query the full metadata and echoable creation parameters of a single Acting World. Before calling, confirm the following:
  • Authentication: Only the primary API Key is supported; temporary API Keys cannot be used (error code 403003).
  • Prerequisites: Query with the encryptedWorldId returned by Create World. For build-progress polling, use Query World Build Status.
  • Caller: Called by your server.
If the model call fails and returns an error, see HappyOyster Error Codes to resolve it.

Authorizations

​
string
header
required

QwenCloud API Key. Only the primary API Key (sk- prefix) is supported. See Get an API Key.

Header Parameters

​
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

​
string
required

An Acting encrypted World ID under the current primary account. Returned by Create World.

Response

200-application/json
​
integer

Return code. 0 means success; non-zero is an error code.

​
string

Error message. null on success.

​
object

Response data. null on failure.