附录：运镜指令与回调通知

文档版本：v1.0.0 | 最后更新：2026-06-05
本平台已完整适配海螺（MiniMax / Hailuo）官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

一、运镜指令（[指令] 语法）

对支持运镜的模型，可在 prompt 中通过 [指令] 格式添加运镜指令以实现精确镜头控制。共支持 15 种运镜指令：

类别	指令
左右移	`[左移]`、`[右移]`
左右摇	`[左摇]`、`[右摇]`
推拉	`[推进]`、`[拉远]`
升降	`[上升]`、`[下降]`
上下摇	`[上摇]`、`[下摇]`
变焦	`[变焦推近]`、`[变焦拉远]`
其他	`[晃动]`、`[跟随]`、`[固定]`

使用规则

组合运镜：同一组 [] 内的多个指令会同时生效，如 [左摇,上升]，建议组合不超过 3 个。

顺序运镜：prompt 中前后出现的指令会依次生效，如 "...[推进]，然后...[拉远]"。

自然语言：也支持通过自然语言描述运镜，但使用标准指令能获得更准确的响应。

二、回调通知（callback_url）

通过 callback_url 参数可配置回调，以异步接收任务状态更新通知。

地址验证：配置后，服务器会向 callback_url 发送一个 POST 请求，请求体包含 challenge 字段。服务端需在 3 秒内原样返回该 challenge 值以完成验证。

状态更新：验证成功后，每当任务状态变更时，都会向该 URL 推送最新任务状态。推送数据结构与查询任务接口的响应体一致。

回调推送的 status 取值：

状态	含义
`processing`	生成中
`success`	成功
`failed`	失败

状态更新推送体示例

{
  "task_id": "115334141465231360",
  "status": "success",
  "file_id": "205258526306433",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

回调服务端参考实现（Python / FastAPI）

07-附录-运镜指令与回调

附录：运镜指令与回调通知#

一、运镜指令（[指令] 语法）#

二、回调通知（callback_url）#

附录：运镜指令与回调通知

一、运镜指令（[指令] 语法）

二、回调通知（callback_url）