跳转到主要内容
Adventure

HappyOyster-Adventure-查询World列表 API参考

分页查询当前千问AI平台账号名下的 Adventure World。接口自动按模型隔离,不会返回 Directing 或 Acting World。

GET
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds
cURL - 查询World列表
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds?page=1&pageSize=20&status=ready' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "code": 0,
  "message": null,
  "data": {
    "items": [
      {
        "encryptedWorldId": "enc_a1b2****",
        "name": "赛博朋克侦探世界",
        "status": "ready",
        "mode": 1,
        "previewUrl": null,
        "createdAt": "2026-06-03T10:00:00Z",
        "perspective": "first_person",
        "creationModel": "simple",
        "uploadMode": "first_frame"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "total": 1,
      "hasMore": false
    }
  }
}

适用范围

分页查询当前千问AI平台账号名下的 Adventure World。调用前请确认:
  • 仅支持主 API Key调用,临时 API Key 不可用(错误码 403003)。
  • 接口自动按模型隔离,不会返回 Directing 或 Acting World,items[].mode 恒为 1。
  • 列表项是轻量快照,需要完整配置时调用查询World详情。
调用失败时,请参见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。

查询参数

integer
默认值1

页码,默认 1。page <= 0 时按 1 处理。

integer
默认值20

每页条数,默认 20。pageSize <= 0 时按 20,大于 100 时按 100 处理。

enum<string>

按构建状态筛选。未知值不筛选。可选值:generating(构建中)、ready(就绪)、failed(构建失败)。

generating,ready,failed
integer

无需传入。列表已按 Adventure 模型过滤,items[].mode 恒为 1。若仍传入且非 1 返回 400000。

响应

200-application/json
integer

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

string

错误信息。成功时为 null。

object

响应数据。失败时为 null。