HappyOyster-Acting-结束Travel API参考-大模型服务平台百炼(Model Studio)-阿里云帮助中心

主动结束 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。

美国（弗吉尼亚）

POST https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/end

调用时请将{WorkspaceId}替换为真实的Workspace ID。

请求参数

正常结束

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "HappyOyster-Web/1.2.0"
}'

无推流超时结束

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "failCode": "TRAVEL_NO_STREAM_AUTO_END",
    "userAgent": "HappyOyster-Web/1.2.0"
}'

Content-Typestring（必选）

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

Authorization string （必选）

API Key 鉴权。不强制主 API Key，主 API Key 或临时 API Key 均可调用。

主 API Key：以 sk- 开头，如 sk-xxx。
临时 API Key：以 st- 开头，如 st-xxx。

请求体（Request Body）

encryptedTravelId string （必选）

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

failCode string （可选）

无推流超时的失败结束原因。省略时按正常结束处理。当前仅支持：

TRAVEL_NO_STREAM_AUTO_END：用于进入房间后超过 noStreamAutoEndTimeoutSec 仍未收到推流的场景，该结束方式不生成回放产物

传入未支持的值返回 400000。

userAgent string （可选）

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

响应参数

正常结束

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "completed",
        "endedAt": "2026-09-09T08:33:00Z",
        "durationSec": 180
    }
}

无推流超时结束

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "failed",
        "errorCode": "TRAVEL_NO_STREAM_AUTO_END",
        "errorMessage": "Something went wrong.",
        "endedAt": "2026-09-09T08:33:00Z",
        "durationSec": null
    }
}

code integer

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

message string

错误信息。成功时为 null。

data object

响应数据。失败时为 null。

属性

encryptedTravelId string

已结束的加密 Travel ID。

status string

结束状态：

completed：正常结束
failed：带受支持 failCode 时的失败结束

errorCode 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。