MiniMax-H3 概览
UniGateway 为 MiniMax-H3 提供异步视频生成接口。提交请求后，接口返回任务 ID；应用随后查询任务状态，并在生成完成后获取视频结果。
支持的模型
| 模型 ID | 说明 |
|---|---|
MiniMax-H3 | MiniMax-H3 视频生成模型。 |
模型访问权限和可用性以当前 API Key、账户配置及接口实际返回为准。
准备工作
请前往 UniGateway API Keys 创建或获取 API Key。调用前确认 API Key 已启用、具有 MiniMax-H3 的访问权限，并且账户余额和消费限额满足调用要求。
API 地址与鉴权
| 项目 | 值 |
|---|---|
| Base URL | https://api.unigateway.ai |
| 创建任务 | POST /v2/video_generation |
| 查询任务 | GET /v2/query/video_generation/{task_id} |
| 鉴权请求头 | Authorization: Bearer <YOUR_UNIGATEWAY_API_KEY> |
| 创建请求内容类型 | Content-Type: application/json |
Base URL 不包含 /v1 或 /v2，接口路径已经包含 /v2，拼接时不要重复添加。
创建任务的完整地址为：
https://api.unigateway.ai/v2/video_generation
查询任务的完整地址为：
https://api.unigateway.ai/v2/query/video_generation/{task_id}
调用流程
- 调用
POST /v2/video_generation，传入模型、提示词和生成参数。 - 保存创建响应中的
task_id。 - 使用该 ID 调用
GET /v2/query/video_generation/{task_id}。 - 检查
task.status；当状态为succeeded且task.content.url非空时，获取视频结果。 - 读取
task.usage查看任务用量，并在控制台查看计费信息。
创建成功表示任务已受理，视频会在后台异步生成。
请求示例
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "A red toy car moves slowly across a white tabletop, fixed camera, continuous shot."
}
],
"resolution": "2K",
"duration": 4,
"ratio": "16:9"
}
此示例请求生成一个 4 秒、2K 分辨率、16:9 画面比例的视频。以上为示例参数，不代表全部可选值或参数组合。
创建响应
{
"task_id": "PUBLIC_TASK_ID"
}
查询任务时，将返回的 task_id 放入查询地址的路径参数中。
查询结果
查询响应包含 task 对象，关键字段如下：
| 字段 | 说明 |
|---|---|
task.id | 任务 ID。 |
task.status | 当前任务状态。 |
task.content.url | 结果可用时返回的生成视频地址。 |
task.model | 本次生成使用的模型。 |
task.duration | 视频时长，单位为秒。 |
task.resolution | 视频分辨率。 |
task.ratio | 视频画面比例。 |
task.usage | 任务用量信息。 |
完整响应示例和字段说明请参见“查询任务”文档。
用量与计费
查询结果的 task.usage 中可能包含 input_image_count、input_seconds、output_seconds 和 total_seconds，用于展示任务返回的用量信息。不要直接使用请求中的 duration 代替最终计费用量。适用价格与实际费用以控制台和账单记录为准。
结果保存与异常处理
- 视频结果地址可能包含签名和有效期，请保留完整 URL，并及时保存需要的视频。
- 跟踪生成进度时，查询已有任务即可，无需重新创建任务。
- 查询请求发生临时网络异常时，可适当延迟后查询同一任务。
- 创建请求超时时，先核查是否已创建任务，再决定是否重新提交。