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

HappyOyster-Adventure-查询Travel产物 API参考

查询已完成 Adventure Travel 的录制原片和三个合成变体。对外交付推荐使用 withInstructionAndWatermark。

GET
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/artifacts
cURL - 查询Travel产物
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/artifacts?encryptedTravelId={encryptedTravelId}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedTravelId": "trvl_a1b2****",
    "composeStatus": "ready",
    "video": {
      "original": {
        "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_raw.mp4?v=2",
        "status": "ready",
        "resolution": "720p",
        "durationSec": 90
      },
      "withWatermark": {
        "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_wm.mp4?v=2",
        "status": "ready",
        "resolution": null,
        "durationSec": 90
      },
      "withInstruction": {
        "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_overlay.mp4?v=2",
        "status": "ready",
        "resolution": null,
        "durationSec": 90
      },
      "withInstructionAndWatermark": {
        "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_all.mp4?v=2",
        "status": "ready",
        "resolution": null,
        "durationSec": 90
      }
    }
  }
}

适用范围

查询已完成 Adventure Travel 的录制原片和三个合成变体。withInstruction 在 Adventure 中表示探索交互贴图版，不是文本指令字幕版。对外交付推荐使用 withInstructionAndWatermark。调用前请确认：
  • 仅支持主 API Key调用，临时 API Key 不可用（错误码 403003）。
  • Travel 状态为 completed，原片 URL 可用是返回产物响应的前提。可通过查询Travel状态接口确认。
  • composeStatus != ready 时可按受控间隔轮询。
调用失败时，请参见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
必填

状态为 completed 的 Adventure 加密 Travel ID。由客户端进入房间接口返回。

响应

200-application/json
​
integer

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

​
string

错误信息。成功时为 null。

​
object

响应数据。失败时为 null。