MiniMax H3 Max Text-to-Video
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 ID | minimax-h3-max/text-to-video |
|---|---|
| 类型 | 文生视频 |
| 接口 | POST /v1/tasks |
| 价格 | 查看实时价格 |
从文字生成视频，可选择横屏、竖屏或方形等六种画幅。支持 480P、768P、1080P、0.92–15 秒目标时长，并可使用自己的音频。
生产建议
生产环境建议
- 使用 callback.url 接收任务终态通知，并按 taskId 去重处理。
- 等待中的任务继续查询；避免重复提交同一个生成请求。
请求参数
model string 必填 选择要调用的模型。
input object 必填 视频生成参数。
prompt string 必填 描述场景、动作、镜头和声音，1–50,000 个字符，不能只包含空白。
duration number 可选 生成视频的目标时长，范围 0.92–15 秒，可使用小数；传入 target_audio_url 时至少为 2 秒。
resolution enum 可选 选择视频清晰度。1080P 在 768P 画面基础上细化，输出宽高还随画幅变化。
seed integer 可选 控制生成的随机性，传入整数，0 也有效；省略时随机选择。
prompt_expansion_mode enum 可选 控制提示词扩写：disabled 保留原提示词，balanced 兼顾扩写与等待时间，quality 进行更充分的扩写，可能增加等待时间。
target_audio_url string 可选 用自己的音频替换视频音轨。传入可公开访问的 HTTP(S) 音频链接，音频至少 2 秒且不超过 15 MB；较长音频截取开头，较短音频补静音，不改变播放速度或视频目标时长。
aspect_ratio enum 可选 生成视频的宽高比，例如横屏 16:9、竖屏 9:16 或方形 1:1。
callback object 可选 任务结束后接收通知的回调配置。
url string 必填 接收任务通知的 HTTPS 地址。
when enum 可选 任务进入终态时触发通知。
用例示例
竖屏纸船与音频
选择竖屏画幅，并用音频链接替换音轨。
请求体
{
"model": "minimax-h3-max/text-to-video",
"input": {
"prompt": "A red paper boat drifts beneath a stone bridge after rain. Smooth tracking camera, natural ripples, soft birdsong. No text or subtitles.",
"duration": 2,
"resolution": "768P",
"target_audio_url": "https://static.hiapi.ai/model-onboarding/minimax-h3-max/2026/10/13/1791862423253-b835317bfd92f652-target-audio.wav",
"aspect_ratio": "9:16"
}
}获取结果
- 使用 Authorization: Bearer YOUR_HIAPI_API_KEY 认证，提交后保存返回的 taskId。
- 通过 GET /v1/tasks/{taskId} 查询，或用 callback.url 接收任务终态通知。
- 排队或生成中继续查询，不重复提交；成功后从 output[].url 读取视频地址。
- 失败时根据返回的错误信息处理；回调接收端应按 taskId 去重。
常见问题
可以用图片指定开头或结尾吗？
请使用 minimax-h3-max/image-to-video，并提供首帧、尾帧或两张图片；本接口只接收文字与可选目标音频。
自己的音频会改变视频长度吗？
不会，视频目标时长由 duration 设置。target_audio_url 替换音轨，长于视频的音频截取开头，短于视频的音频补静音。请准备至少 2 秒且不超过 15 MB 的音频。
怎样保留原提示词、不做扩写？
设置 prompt_expansion_mode 为 disabled。需要更充分的描述时可选择 quality，并为生成预留更多等待时间。