跳转到主要内容
千问AI平台 home page
文档
Adventure

HappyOyster-Adventure-查询World详情 API参考

查询单个 Adventure World 的完整元数据和可回显创建参数。构建进度轮询请使用查询World构建状态接口。

GET
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/detail
cURL - 查询World详情
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/detail?encryptedWorldId={encryptedWorldId}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedWorldId": "enc_a1b2****",
    "name": "江南雨夜奇遇",
    "status": "ready",
    "mode": 1,
    "creationModel": "simple",
    "prompt": "黄昏的江南水乡，石桥与乌篷船",
    "eventStyle": "normal",
    "perspective": "third_person",
    "uploadMode": "first_frame",
    "resolution": null,
    "aspectRatio": null,
    "layout": null,
    "narrative": null,
    "refWorldId": null,
    "firstFrameImage": {
      "url": "https://cdn.happyoyster.com/frames/jiangnan.jpg",
      "referenceType": "default"
    },
    "inputImages": null,
    "sceneImage": null,
    "roleImage": null,
    "scenePrompt": null,
    "rolePrompt": null,
    "scriptList": null,
    "previewUrl": null,
    "createdAt": "2026-06-03T10:00:00Z",
    "updatedAt": "2026-06-03T10:05:00Z"
  }
}

适用范围

查询单个 Adventure World 的完整元数据和可回显创建参数。调用前请确认：
  • 仅支持主 API Key调用，临时 API Key 不可用（错误码 403003）。
  • 使用创建World接口返回的 encryptedWorldId 查询。构建进度轮询应使用查询World构建状态。
  • 查询其它模型、其它千问AI平台账号或已删除的 World 均返回 403001，不会泄漏资源是否存在。
调用失败时，请参见HappyOyster 错误码。

鉴权

​
string
header
必填

千问AI平台 API Key。仅支持主 API Key（sk- 开头）。详见获取 API Key。

Header 参数

​
string
必填

API Key 鉴权。仅支持主 API Key，以 sk- 开头，如 sk-xxx。通常配置为环境变量 $DASHSCOPE_API_KEY。临时 API Key（st- 开头）调用返回 403003。

查询参数

​
string
必填

当前千问AI平台账号名下的 Adventure 加密 World ID。由创建World接口返回。

响应

200-application/json
​
integer

返回码。0 表示成功，非 0 为错误码。

​
string

错误信息。成功时为 null。

​
object

响应数据。失败时为 null。