向 Acting Travel 发送一条文本指令，驱动后续角色表演和画面生成。Travel 为 running 或 paused 时可调用。
适用范围
向 Acting Travel 发送一条文本指令，驱动后续角色表演和画面生成。调用前请确认以下事项：
- 鉴权要求：不强制主 API Key，主 API Key 或临时 API Key 均可调用。获取方式请参见获取鉴权凭证。
- 前置条件：Travel 状态需为
running或paused。可通过查询Travel状态接口确认。 - 调用方：您的服务端或客户端均可调用。
HTTP调用
- 新加坡
- 美国（弗吉尼亚）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/instruct调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数 |
|
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。 | |
Authorization string （必选）API Key 鉴权。不强制主 API Key，主 API Key 或临时 API Key 均可调用。
| |
请求体（Request Body） | |
encryptedTravelId string （必选）要控制的 Acting 加密 Travel ID。由客户端进入房间接口返回。 | |
content string （必选）文本过程指令。非空，最长 2000 字符；缺失、为空或超限返回 400000。 | |
clientRequestId string （可选）指令重试的计费幂等键。同一条逻辑指令重试时复用同值，避免重复计费。推荐格式 [A-Za-z0-9_-]{1,32}。
| |
userAgent string （可选）SDK 或客户端版本标识。非空字符串，优先于 HTTP User-Agent。 |
响应参数 |
|
code integer返回码。0 表示成功，非 0 为错误码。 | |
message string错误信息。成功时为 null。 | |
data object响应数据。失败时为 null。
属性 encryptedTravelId string加密的 Travel ID。content string已接受的指令文本。accepted boolean是否已接受指令并进入处理流程。 |
前置状态与调用注意事项
- Travel 状态必须为
running或paused。 content必填、不可为空或只有空白字符，最长 2000 字符。- 在
paused状态发送指令只会接受指令，不会自动恢复 Travel；需要继续运行时，客户端必须另行调用恢复Travel。 - 同一条逻辑指令重试时应复用
clientRequestId，以避免重复计费。 - 已结束或失败的 Travel 不可写。
- 指令未通过内容安全策略时返回
403004。 - Acting 的
creationModel恒为simple，不需要判断 ScriptList 子模式。
错误码
如果模型调用失败并返回报错信息，请参见HappyOyster 错误码进行解决。
下一步
发送指令后：
- 查询Travel状态：查看指令执行状态和章节信息。
- 暂停Travel / 恢复Travel：控制运行节奏。
- 结束Travel：结束会话并处理产物。