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

HappyOyster-Adventure-结束Travel API参考

主动结束 Adventure Travel。正常结束后进入 completed；无推流超时结束时进入 failed，且不生成回放产物。达到 maxExperienceTimeSec 时服务端也会自动结束。

POST
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/end
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/end' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "encryptedTravelId": "{encryptedTravelId}",
  "userAgent": "HappyOyster-Web/0.1.0"
}'
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedTravelId": "trvl_a1b2****",
    "status": "completed",
    "errorCode": null,
    "errorMessage": null,
    "endedAt": "2026-06-04T00:03:00Z",
    "durationSec": 90
  }
}

适用范围

主动结束 Adventure Travel。正常结束后 Travel 进入 completed；无推流超时结束时进入 failed。调用前请确认：
  • 不强制主 API Key，主 API Key 或临时 API Key 均可调用。
  • Travel 必须尚未进入终态，并处于服务端可结束的状态。可通过查询Travel状态接口确认。
  • 达到 maxExperienceTimeSec 后服务端会自动结束 Travel；客户端应以状态回调或状态查询结果收敛本地状态。
调用失败时，请参见HappyOyster 错误码。

鉴权

​
string
header
必填

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

Header 参数

​
string
默认值"application/json"
必填

请求内容类型。此参数必须设置为 application/json。

​
string
必填

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

请求体

application/json
​
string
必填

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

​
enum<string>

无推流超时的失败结束原因。省略时按正常结束处理。当前仅支持 TRAVEL_NO_STREAM_AUTO_END（用于进入房间后超过 noStreamAutoEndTimeoutSec 仍未收到推流的场景，该结束方式不生成回放产物）。传入未支持的值返回 400000。

可选值：TRAVEL_NO_STREAM_AUTO_END
​
string

SDK 或客户端版本标识。非空字符串，优先于 HTTP User-Agent。

响应

200-application/json
​
integer

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

​
string

错误信息。成功时为 null。

​
object

响应数据。失败时为 null。