MiniMax H3 API

Generate MiniMax H3 videos from simple text prompts or full multimodal inputs, manage asynchronous tasks, use Context-IR, and regenerate eligible output in 2K.

原始信息汇总

MiniMax H3 API 数据集详情

基本信息

• 所属类别：视频、图像（Video, Images）
• API 创建者：Kairox-Org
• 订阅者数量：2
• API 版本：1.0.0（当前版本）
• 产品网站：有提供

核心功能

MiniMax H3 API 为异步 H3 视频生成提供生产级接口，主要功能包括：

1. 视频生成：

   • 支持从单一文本提示（prompt）生成视频
   • 支持完整的多模态输入，包括文本转视频、首帧/末帧图像转视频
   • 支持基于图像、视频和音频的参考生成
   • 支持 H3-Context-IR（基于多模态上下文生成增强提示）
   • 支持将 768P 生成结果再生成（regenerate）为 2K 分辨率

2. 任务管理：

   • 创建视频生成任务
   • 查询指定任务状态
   • 按任务 ID 列表查询
   • 取消排队中的任务或删除已完成的任务记录

3. 认证机制：

   • MiniMax 认证由 API 运营商完全托管
   • 订阅者无需发送或暴露 MiniMax API 密钥
   • RapidAPI 负责处理订阅者认证后再转发请求
   • 后端不验证 RapidAPI 凭据
   • 每个被接受的任务返回一个隐藏原始提供商任务 ID 的签名公钥

使用流程

1. 创建视频任务：通过 POST /api/v1/generations 提交请求，最小请求体仅需包含 prompt 字段，返回 HTTP 202 状态码及签名 task_id 和 links.task
2. 轮询任务状态：通过 GET /api/v1/tasks/{task_id} 查询，建议每 5-10 秒轮询一次，当状态变为 succeeded 时从 data.content.url 或 data.links.video 获取生成的视频

其他操作说明

• POST /api/v1/context-ir：解释多模态上下文并生成增强提示
• POST /api/v1/regenerations：将有资格的 H3 768P 输出再生成为 2K
• GET /api/v1/tasks?task_ids=...：仅检索调用者拥有的签名任务 ID
• DELETE /api/v1/tasks/{task_id}：取消排队任务或删除已完成任务记录

最小请求默认值

• 模型：MiniMax-H3
• 分辨率：768P
• 时长：5秒
• 宽高比：16:9

计费说明

• 计算单元（H3ComputeUnits）的使用基于输出时长和分辨率：768P 每秒 8 个单元，2K 每秒 13 个单元
• RapidAPI 应用被接受响应报告的增加值
• 验证失败和被拒绝的任务创建消耗 0 个计算单元
• 图像和音频参考可用；超过前五张图像后，每张额外增加 4 个计算单元

错误处理规范

错误使用稳定的 JSON 信封格式，包含 success、error（含 code 和 message）及 request_id 字段。常见状态码含义：

• 400：无效输入
• 402：上游余额不足
• 403：无效的签名任务标识符
• 404：任务不可用
• 422：内容被拒绝
• 429：达到速率限制
• 502：提供商失败

重要注意事项

• MiniMax 任务记录和输出 URL 是临时的，应尽快存储已授权的完成输出
• 当任务被接受时即消耗提供商容量，无论之后是否下载输出
• 引用视频输入和直接基础视频再生成目前暂时不可用，因为精确的源时长计量仍在定稿中
• 上游余额、访问权限、内容审核和速率限制仍然适用