向普通模式 Travel 发送一条文本指令，驱动后续画面生成。仅 creationModel=simple 支持；scriptlist Travel 应使用剧本全量更新。
适用范围
向普通模式（creationModel=simple）Travel 发送一条文本指令，驱动后续画面生成。调用前请确认以下事项：
- 鉴权要求：不强制主 API Key，主 API Key 或临时 API Key 均可调用。获取方式请参见获取鉴权凭证。
- 前置条件：Travel 的
creationModel必须为simple，状态需可接收指令。可通过查询Travel状态接口确认。 - 调用方：您的服务端或客户端均可调用。
HTTP调用
- 新加坡
- 美国（弗吉尼亚）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/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 （必选）要控制的 Directing 加密 Travel ID，creationModel 必须为 simple。由客户端进入房间接口返回。 | |
content string （必选）文本过程指令。非空，最长 2000 字；为空或超过 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是否已接受指令并进入处理流程。 |
前置状态与调用注意事项
- 仅
creationModel=simple支持本接口；scriptlistTravel 应使用剧本全量更新，误调用instruct返回403006。 - Travel 当前状态必须可接收指令；已结束或失败的 Travel 不可写。
content为空或超过 2000 字时返回400000。- 建议每次逻辑指令生成稳定的
clientRequestId，重试时复用。 - 指令未通过内容安全策略时返回
403004。
错误码
如果模型调用失败并返回报错信息，请参见HappyOyster 错误码进行解决。
下一步
发送指令后：
- 查询Travel状态：查看指令执行状态和章节信息。
- 暂停Travel / 恢复Travel / 回溯Travel。
- 结束Travel：结束会话并处理产物。