MiniMax H3 API

MiniMax H3 视频生成模型的完整 API 参考文档。

模型变体

此 API 支持三种模型变体：

快速比较

支持的宽高比

文生视频和参考生成视频支持：

21:9, 16:9, 4:3, 1:1, 3:4, 9:16

分辨率选项

MiniMax H3 文生视频

端点

POST /api/v1/video/task

请求参数

必填

请求示例

javascript复制
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'minimax-h3-text-to-video',
    prompt: '一只金毛寻回犬奔跑在阳光照耀的草地上',
    duration: 8,
    resolution: '2k',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

MiniMax H3 图生视频

端点

POST /api/v1/video/task

请求参数

必填

可选

注意： 图生视频不支持 aspect_ratio。

请求示例

javascript复制
{
  model_name: 'minimax-h3-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: '镜头缓慢拉远，展现完整的景观',
  duration: 8,
  resolution: '2k'
}

MiniMax H3 参考生成视频

根据可选的图像、视频和音频参考生成新视频。

端点

POST /api/v1/video/task

请求参数

必填

参考媒体

@ (AT) 参考占位符

@ (AT) 参考功能通过带编号的 <<<...>>> 占位符将参考媒体关联到提示词。每种媒体类型均单独从 1 开始编号，并按照对应数组的顺序排列。

例如，如果第一张图像是角色参考，第二张图像是场景参考，则在 prompt 中使用 <<<image_1>>> 指代角色，使用 <<<image_2>>> 指代场景。每个占位符必须指向对应数组中实际存在的项目。

请求示例

javascript复制
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: '使用图像一作为主体、视频一作为动作参考，并使用音频一营造氛围',
  duration: 8,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

@ (AT) 参考生成视频请求示例

javascript复制
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: '将 <<<image_1>>> 中的探险家置于 <<<image_2>>> 中的环境，让其跟随 <<<video_1>>> 中的镜头运动，并使用 <<<audio_1>>> 中的参考声音说话',
  duration: 10,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.jpg'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

响应格式

初始响应

所有模型都会返回用于轮询的 task_id：

json复制
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

轮询响应

轮询 GET /api/v1/video/{taskId} 以检查状态：

json复制
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

状态值

• submitted：任务已接受并等待处理
• processing：正在生成视频
• succeed：视频生成完成
• failed：视频生成失败

最佳实践

1. 清晰描述动作：在提示词中包含具体的动作描述
2. 选择分辨率：使用 768p 获得更快的处理速度，使用 2k 获得更高质量的输出
3. 图像质量：对于图生视频，请使用高质量输入图像以获得最佳效果
4. 参考项顺序：按照预期顺序排列 images、videos 和 audios，并在提示词中始终以一致方式引用它们
5. @ (AT) 参考：当您需要明确控制由哪个参考素材驱动场景的各个部分时，请使用 <<<image_N>>>、<<<video_N>>> 和 <<<audio_N>>> 占位符