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

HappyOyster-Adventure-查询Travel状态 API参考

查询 Adventure Travel 生命周期、服务端推流状态和当前世界的动作池，也可同时上报客户端拉流或播放心跳。

GET
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/status
cURL - 查询Travel状态
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/status?encryptedTravelId={encryptedTravelId}&clientStreamStatus=PLAYING&clientStreamStatusTimeMs=1788940800000' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedTravelId": "trvl_a1b2****",
    "status": "running",
    "rtcStatus": "PUSHING",
    "updateTime": "2026-06-04T00:02:00Z",
    "userInstructions": null,
    "chapters": null,
    "characterActions": [
      "dash",
      "jump",
      "crouch",
      "attack"
    ],
    "environmentActions": [
      "ride_motorcycle",
      "enter_exit_car"
    ]
  }
}

适用范围

查询 Adventure Travel 生命周期、服务端推流状态和当前世界的动作池，也可同时上报客户端拉流或播放心跳。调用前请确认：
  • 不强制主 API Key，主 API Key 或临时 API Key 均可调用。
  • 使用客户端进入房间接口返回的 encryptedTravelId 查询，建议每 2-5 秒轮询。
  • Adventure 不支持 HTTP instruct、pause、resume、rewind、update-script；不要围绕暂停 / 恢复构建状态机。
调用失败时，请参见HappyOyster 错误码。

鉴权

​
string
header
必填

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

Header 参数

​
string
必填

API Key 鉴权。不强制主 API Key，主 API Key 或临时 API Key 均可调用。主 API Key 以 sk- 开头，如 sk-xxx；临时 API Key 以 st- 开头，如 st-xxx。

查询参数

​
string
必填

Adventure 加密 Travel ID。由客户端进入房间接口返回。

​
enum<string>

客户端 RTC 拉流或播放状态，大小写不敏感。无法识别的值会被忽略。可选值：DISCONNECTED（未连接或已离开频道）、CONNECTING（正在连接 RTC 频道）、CONNECTED（已入会，尚未开始播放或首帧未到达）、PLAYING（已收到远端流并正在渲染）、BUFFERING（缓冲中）、PAUSED（客户端暂停播放，不表示 Adventure Travel 支持服务端暂停）、RECONNECTING（重连中）。

可选值：DISCONNECTED,CONNECTING,CONNECTED,PLAYING,BUFFERING,PAUSED,RECONNECTING
​
integer

客户端状态变更的毫秒时间戳。与 clientStreamStatus 配套使用。

响应

200-application/json
​
integer

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

​
string

错误信息。成功时为 null。

​
object

响应数据。失败时为 null。