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

HappyOyster-Adventure-客户端进入房间 API参考

客户端使用 ticket 创建实际 Travel，并获取 RTC 入会配置和 Adventure 能力版本。maxExperienceTimeSec 仅在 Adventure 模型中生效。

POST
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/enter-travel
cURL - 客户端进入房间
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/enter-travel' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "ticket": "{ticket}",
  "maxExperienceTimeSec": 90
}'
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedTravelId": "trvl_a1b2****",
    "encryptedWorldId": "enc_a1b2****",
    "mode": 1,
    "creationModel": "simple",
    "playUrl": null,
    "firstFrame": "https://cdn.happyoyster.com/frames/world_xyz789.jpg",
    "rtcConfig": {
      "channelId": "stream_abc123",
      "appId": "18bca2e3218c46aebf8ff3a32fb12311",
      "token": "007eJxTYOh...",
      "userId": "user_1"
    },
    "version": "wanderV2",
    "aspectRatio": null,
    "noStreamAutoEndTimeoutSec": 30,
    "maxExperienceTimeSec": 90
  }
}

适用范围

客户端使用 ticket 创建实际 Travel，并获取 RTC 入会配置。maxExperienceTimeSec 仅在 Adventure 模型中生效。调用前请确认：
  • 不强制主 API Key，使用 ticket 完成进房校验。
  • ticket 由获取体验凭证接口换取，未过期且未使用，对应 World 状态为 ready。
  • version 固定为 wanderV2，须按此版本通过 SDK sendCommand 发送控制数据。
调用失败时，请参见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
必填

未过期且未使用的一次性凭证。由获取体验凭证接口换取。同一 ticket 再次使用返回 401011。

​
enum<integer>
默认值60

最大体验时长，单位秒，必须是 JSON 整数。默认 60。可选值：60、90、120。不接受字符串或其它数值（如 "60" 不是合法值）；非法档位返回 400000。服务端在达到该时长后自动结束 Travel。

可选值：60,90,120

响应

200-application/json
​
integer

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

​
string

错误信息。成功时为 null。

​
object

响应数据。失败时为 null。