客户端使用 ticket 创建实际 Travel，并获取 RTC 入会配置、Acting 能力版本和播放器画幅。调用成功即创建 Travel。
适用范围
客户端使用 ticket 创建实际 Travel，并获取 RTC 入会配置、Acting 能力版本和播放器画幅。调用前请确认以下事项：
- 鉴权要求：不强制主 API Key，使用
ticket完成进房校验。获取方式请参见获取鉴权凭证。 - 前置条件：
ticket由获取体验凭证接口换取，未过期且未使用，对应 World 状态为ready。 - 调用方：您的客户端调用。
HTTP调用
- 新加坡
- 美国（弗吉尼亚）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/enter-travel调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数 |
|
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。 | |
Authorization string （必选）API Key 鉴权。不强制主 API Key，主 API Key 或临时 API Key 均可调用。
| |
请求体（Request Body） | |
ticket string （必选）未过期且未使用的一次性凭证。由获取体验凭证接口换取。同一 ticket 再次使用返回 401011。 |
Acting 进房不消费
maxExperienceTimeSec，请勿传入。若仍传入非法档位，会在模型分流前返回 400000。响应参数 |
|
code integer返回码。0 表示成功，非 0 为错误码。 | |
message string错误信息。成功时为 null。 | |
data object响应数据。失败时为 null。
属性 encryptedTravelId string新创建的加密 Travel ID。后续查询Travel状态、暂停、恢复、结束、产物查询均使用此值。encryptedWorldId string当前 Travel 对应的加密 World ID。mode integerActing 恒为 3。creationModel stringActing 恒为 simple。playUrl null暂不可用，固定为 null。firstFrame stringWorld 首帧 URL。rtcConfig objectRTC 入会配置；没有可用推流频道时为 null，客户端不能据此开始播放。
stringActing 进房版本，固定为 actingV2。须按此版本调用控制接口。aspectRatio string画幅。客户端须在拉流前据此设置播放器方向：
integer无推流自动结束超时秒数，默认 30，以实际响应为准。进房后若在此时间内 rtcStatus 未进入推流态，应调用结束Travel并传入 failCode=TRAVEL_NO_STREAM_AUTO_END。maxExperienceTimeSec nullActing 不使用最大体验时长，固定返回 null。 |
前置状态与调用注意事项
ticket对应的 World 必须为ready，且 ticket 未过期、未使用。- 调用成功即创建 Travel；同一
ticket再次使用返回401011。 - Acting 功能或规格未开通时返回
403007，且不会创建 Travel。 version必须按actingV2处理；不要按其它能力版本调用控制接口。- 客户端应在建立拉流或渲染容器前读取
aspectRatio：9:16使用竖屏容器，16:9使用横屏容器。 - 不要传
maxExperienceTimeSec。Acting 不按该字段自动结束，客户端不能据此做倒计时。 rtcConfig=null表示当前没有可用推流频道，客户端不能据此开始播放。
错误码
如果模型调用失败并返回报错信息，请参见HappyOyster 错误码进行解决。
下一步
进房成功后：
- 查询Travel状态：每 2–5 秒轮询，Travel 为
running或paused时可发送指令。 - 发送文本过程指令：驱动后续角色表演。
- 暂停Travel / 恢复Travel：按需控制运行节奏。
- 结束Travel：结束时进入
completed，开始处理产物。