HappyOyster-Adventure-Query World Build Status API Reference

​

Scope

• Authentication: The primary API Key is not required; either the primary or a temporary API Key can call this endpoint. For how to obtain them, see Obtain authentication credentials.
• Prerequisites: Query with the encryptedWorldId returned by Create World. You can start querying from the generating state.
• Caller: Either your server or your client can call it.

​

HTTP request

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/build-status?encryptedWorldId={encryptedWorldId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "status": "generating",
        "firstFrame": null
    }
}

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "status": "ready",
        "firstFrame": "https://cdn.happyoyster.com/frames/world_xyz789.jpg",
        "name": "Cyberpunk Detective World",
        "mode": 1
    }
}

​

Prerequisite states and call notes

• Poll every 3–5 seconds until status is ready or failed.
• Only a ready World can exchange for a travel credential and enter the room.
• When a URL image fails validation after asynchronous storage, the World may go from generating to failed.
• This endpoint does not return aspectRatio; when you need creation metadata such as perspective or uploadMode, call Query World Detail.

​

Error codes

​

Next steps

• Get Travel Credential: exchange for a single-use ticket.
• Query World Detail: query the full creation metadata.