GPT Image 2最低 $0.030/张选择 MiniMax H3 视频工作流，跑通异步任务，区分请求错误与生成失败，再安全切换到 callback。
选一个模型，输入你的提示词，直接查看生成结果。
HiAPI Blog
HiAPI
现在就用 HiAPI 生成
MiniMax H3 使用同一个 minimax-h3 模型 ID 提供三种视频工作流：纯提示词生成、首尾帧控制和多模态参考视频。稳定的接入流程要先选定一种工作流，用最小输入跑通异步任务，再把请求校验错误和生成阶段失败分开处理。
需要字段名称、限制、callback 或可复制的 curl、Python、Node.js 示例时，以 MiniMax H3 API 参数与请求 Schema 为准。本文只讲请求前后的选择、验证和排错顺序。
文生视频最适合验证接入是否畅通。先只传提示词，沿用文档中的默认时长、分辨率、画幅和水印配置，确认 API Key、模型 ID、任务状态和结果下载链路都正常。
首尾帧控制适合必须从指定画面开始，或需要收束到目标画面的镜头。尾帧依赖首帧，提交前要把两张图片作为一组检查。
多模态参考适合用已有图片、视频或音频约束主体、镜头语言、动作或节奏。参考素材字段与首尾帧字段会选择不同生成模式，不应放在同一个请求中。具体素材数量、时长和字段组合统一留在 API Reference，避免教程成为第二份参数表。
| 生产目标 | 建议起点 | 优先验证 |
|---|---|---|
| 先跑通接入 | 文生视频 | API Key、minimax-h3、任务创建、结果下载 |
| 控制开场或结尾 | 首帧或首尾帧 | 图片能被公网访问、首尾帧组合正确 |
| 保持主体或视觉语言 | 多模态参考 | 素材能被公网访问、请求只包含参考模式字段 |
从 MiniMax H3 API Reference 复制最小请求。创建成功后会立即返回 data.taskId。HTTP 200 只表示任务已经创建，视频仍在异步生成。
本地调试时，短暂等待后调用 GET /v1/tasks/{taskId}。任务处于非终态时继续查询，进入 success 或 fail 后停止。成功时从 data.output[].url 读取视频，同时检查 expireAt，在临时链接过期前下载；需要长期保留时应选择持久存储。
这个最小闭环会成为后续排错基线。时长、画幅、首尾帧和参考素材每次只增加一项。新请求失败时，和已通过基线之间的差异足够小，更容易定位。
同步 HTTP 错误表示可用的任务流程尚未开始，应该先检查响应，再修改轮询逻辑。400 INVALID_REQUEST 通常指向请求体，例如时长越界或同时传入两种模式的字段。401、402 对应凭证、权限或余额。415 对应请求 Content-Type。503 属于暂时不可用，可以稍后按退避策略重试。
任务也可能创建成功，随后进入 status: "fail"。这时保留原始 taskId，读取 data.error.code 和 data.error.message。重点检查输入素材是否能通过公网 HTTPS 访问，以及请求是否只选择了一种模式。不了解失败原因就重复提交同一请求，可能产生重复任务和重复计费。
| 现象 | 排错层级 | 下一步 |
|---|---|---|
返回 HTTP 400，没有 taskId | 请求校验 | 修正响应指出的字段或模式冲突 |
| 返回 HTTP 401、402、415 | 账号或传输 | 检查 API Key、余额与 JSON Content-Type |
| 创建前返回 HTTP 503 | 暂时不可用 | 稍后按指数退避重试 |
已有 taskId，状态变成 fail | 生成任务 | 查看 data.error 与输入素材可访问性 |
success 返回临时 URL | 结果保存 | 在 expireAt 前下载或使用持久存储 |
轮询适合调试，因为每个状态变化都能看到。生产服务应在请求体顶层传 callback.url，并使用 callback.when: "final" 接收终态通知。callback 可能表示成功，也可能表示失败，因此两种状态都要处理，并按 taskId 去重。
创建请求可能重试时应携带 Idempotency-Key。同一个账号使用相同 key 和相同请求，会拿到原来的 taskId，可以保护任务创建边界。callback 延迟或遗漏时保留低频轮询做补偿，任务进入终态后立即停止。
产物保存也要放入生产检查清单。临时输出 URL 有访问期限。根据留存需求及时下载、创建任务时选择持久存储，或在过期前把产物升级为持久存储。
MiniMax H3 视频生成模型页 用于了解能力、查看实时按量价格并在 Playground 中验证效果，不重复维护完整请求 Schema。
MiniMax H3 API 参数与请求 Schema 继续作为参数、约束、callback 和可复制代码的来源。统一异步任务生命周期 则覆盖不同模型共用的请求头、任务状态、callback 和存储规则。
先测试只传提示词的文生视频。它涉及的变量最少，可以先验证 API Key、模型 ID、异步任务状态和结果下载，再增加媒体输入。
视频任务是异步的。创建响应返回 data.taskId，之后查询任务或等待 callback；只有状态进入 success 后才从 data.output[].url 读取结果。
同步校验错误要先修正再提交。创建阶段的 503 可以按退避策略重试。已经拿到 taskId 后，应继续查看原任务或等待 callback，避免重复提交相同请求。
以 MiniMax H3 模型页 的实时价格为准。本文不写固定单价，避免价格调整后留下过期数字。
