主动结束 Acting Travel。正常结束后进入 completed 并开始处理产物；无推流超时结束时进入 failed，且不生成回放产物。
适用范围
主动结束 Acting Travel。正常结束后 Travel 进入 completed 并开始处理产物；无推流超时结束时进入 failed，且不生成回放产物。调用前请确认以下事项：
- 鉴权要求：不强制主 API Key，主 API Key 或临时 API Key 均可调用。获取方式请参见获取鉴权凭证。
- 前置条件：Travel 必须尚未进入终态，并处于服务端可结束的状态。可通过查询Travel状态接口确认。
- 调用方：您的服务端或客户端均可调用。
HTTP调用
- 新加坡
- 美国（弗吉尼亚）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/end调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数 |
|
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。 | |
Authorization string （必选）API Key 鉴权。不强制主 API Key，主 API Key 或临时 API Key 均可调用。
| |
请求体（Request Body） | |
encryptedTravelId string （必选）要结束的 Acting 加密 Travel ID。由客户端进入房间接口返回。 | |
failCode string （可选）无推流超时的失败结束原因。省略时按正常结束处理。当前仅支持：
400000。 | |
userAgent string （可选）SDK 或客户端版本标识。非空字符串，优先于 HTTP User-Agent。 |
响应参数 |
|
code integer返回码。0 表示成功，非 0 为错误码。 | |
message string错误信息。成功时为 null。 | |
data object响应数据。失败时为 null。
属性 encryptedTravelId string已结束的加密 Travel ID。status string结束状态：
string失败原因代码。仅失败结束时返回。errorMessage string失败说明。仅失败结束时返回。endedAt string结束时间，ISO 8601 格式；暂不可用时可为 null。durationSec integer有效视频时长秒数；无推流失败结束或时长尚不可解析时为 null。 |
前置状态与调用注意事项
encryptedTravelId必须属于当前主账号和 Acting 模型。- Travel 必须尚未进入终态，并处于服务端可结束的状态。
failCode省略时按正常结束处理；传入未支持的值返回400000。- 正常结束的
durationSec优先使用可用成片的实际时长；成片时长尚不可解析时可能为null。 - Acting 不使用
maxExperienceTimeSec，不会因客户端传入该值而按该时长自动结束。 - 正常结束为
completed后，合成产物仍可能继续处理，应按查询Travel产物查询并轮询。
错误码
如果模型调用失败并返回报错信息，请参见HappyOyster 错误码进行解决。
下一步
Travel 进入 completed 后：
- 查询Travel产物：轮询获取录制原片和合成变体。
- 查询Travel列表：查看历史 Travel。