在剧本模式 Travel 中提交完整的 45 个 turn，全量替换当前 Travel 的 acts。仅 creationModel=scriptlist 支持。
适用范围
在剧本模式（creationModel=scriptlist）Travel 中提交完整的 45 个 turn，全量替换当前 Travel 的 acts。调用前请确认以下事项：
- 鉴权要求：不强制主 API Key，主 API Key 或临时 API Key 均可调用。获取方式请参见获取鉴权凭证。
- 前置条件：Travel 的
creationModel必须为scriptlist，状态需为running或pending。可通过查询Travel状态接口确认。 - 调用方：您的服务端或客户端均可调用。
HTTP调用
- 新加坡
- 美国（弗吉尼亚）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/update-script调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数 |
示例中仅展示第 1、2 个 act 用于说明结构，不可直接提交。实际请求必须包含 turn 1–45 共 45 条，连续且不重复。 |
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。 | |
Authorization string （必选）API Key 鉴权。不强制主 API Key，主 API Key 或临时 API Key 均可调用。
| |
请求体（Request Body） | |
encryptedTravelId string （必选）要更新的 Directing 加密 Travel ID，creationModel 必须为 scriptlist。由客户端进入房间接口返回。 | |
scriptList object （必选）全量剧本容器。仅 acts 生效；即使包含 subjects、synopsis、scene、style、speed、language、setting、soundtrack、prologue 或 videoTags，这些字段也会被忽略，平台继续使用创建 World 时已保存的值。scriptList.acts array （必选）完整 act 列表。约束：
| |
userAgent string （可选）SDK 或客户端版本标识。非空字符串，优先于 HTTP User-Agent。 |
响应参数 |
|
code integer返回码。0 表示成功，非 0 为错误码。 | |
message string错误信息。成功时为 null。 | |
data object响应数据。失败时为 null。
属性 encryptedTravelId string加密的 Travel ID。accepted boolean是否已接受完整剧本并进入处理流程。turnCount integer本次全量更新的 turn 数，固定为 45。 |
前置状态与调用注意事项
- 仅
creationModel=scriptlist支持本接口；普通模式 Travel 误调用返回409000。 - Travel 状态必须为
running或pending。 acts必须恰好 45 条；turn 必须为 1–45，连续且不可重复，否则返回400000。- 剧本内容未通过内容安全策略时返回
403004；触发版权或 IP 合规拒绝时返回403005。
错误码
如果模型调用失败并返回报错信息，请参见HappyOyster 错误码进行解决。
下一步
更新后：
- 查询Travel状态：查看章节信息。
- 暂停Travel / 回溯Travel。
- 结束Travel：结束会话并处理产物。