> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Minimax Hailuo 2.3 文生视频

Minimax Hailuo 2.3 是全新升级的视频生成模型，在肢体动作、物理效果和对指令的理解与执行能力等方面表现更为出色。

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/docs/models/reference-get-async-task-result) 来检索视频生成结果。
</Tip>

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="prompt" type="string" required={true}>
  指导生成所需的提示词文本。

  范围: `1 <= x <= 2000`。

  支持 15 种运镜指令的指令:

  * 左右移: \[左移], \[右移]
  * 左右摇: \[左摇], \[右摇]
  * 推拉: \[推进], \[拉远]
  * 升降: \[上升], \[下降]
  * 上下摇: \[上摇], \[下摇]
  * 变焦: \[变焦推近], \[变焦拉远]
  * 其他: \[晃动], \[跟随], \[固定]

  使用规则:

  * 组合运镜: 同一组 \[] 内的多个指令会同时生效，如 \[左摇,上升]，建议组合不超过 3 个
  * 顺序运镜: prompt 中前后出现的指令会依次生效，如 "...\[推进], 然后...\[拉远]"
  * 自然语言: 也支持通过自然语言描述运镜，但使用标准指令能获得更准确的响应
</ParamField>

<ParamField body="duration" type="integer" required={false}>
  生成视频的时长（秒）。默认值：`6`<br />
  可选值：`6`、`10`
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  生成视频的分辨率。默认值：`768P`

  * 6 秒视频支持：`768P`、`1080P`
  * 10 秒视频仅支持：`768P`
</ParamField>

<ParamField body="enable_prompt_expansion" type="boolean" required={false}>
  是否启用提示词优化。

  默认值: `true`。
</ParamField>

<ParamField body="fast_pretreatment" type="boolean" required={false} default={false}>
  是否缩短提示词优化的耗时。

  默认值: `false`。
</ParamField>

<ParamField body="aigc_watermark" type="boolean" required={false} default={false}>
  为生成的视频添加水印。

  * `false`：不添加水印。
  * `true`：在视频添加文字的水印，标识由人工智能生成合成。
</ParamField>

## 响应

<ResponseField name="task_id" type="string" required={true}>
  异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/docs/models/reference-get-async-task-result) 以获取生成结果
</ResponseField>