MiniMax H3

POST

tasks

MiniMax H3

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "image_with_roles": [
    {}
  ],
  "watermark": true,
  "ref_task_id": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "image_urls": ["<string>"],
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "video_urls": ["<string>"],
    "audio_urls": ["<string>"],
    "image_with_roles": [{}],
    "watermark": True,
    "ref_task_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    image_urls: ['<string>'],
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    video_urls: ['<string>'],
    audio_urls: ['<string>'],
    image_with_roles: [{}],
    watermark: true,
    ref_task_id: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"watermark\": true,\n  \"ref_task_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"watermark\": true,\n  \"ref_task_id\": \"<string>\"\n}")
  .asString();

MiniMax H3 是 MiniMax 的全模态视频模型：一个接口同时接受文本、图片、视频和音频输入。本页覆盖三个模型：minimax-h3 输出 768P / 2K 带音轨成片；minimax-h3-max 是高质量版，输出 480P / 768P / 1080P；minimax-h3-regeneration 把已完成的 minimax-h3 768P 任务再生成原生 2K。只要文生视频或首帧生视频、不需要多模态参考时，Hailuo 系列更省。

快速开始

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: h3-demo-001" \
  -d '{
    "model": "minimax-h3",
    "action": "generate",
    "prompt": "清晨的山间小镇，雾气缓缓散开，镜头从屋顶推向远山",
    "duration": 8,
    "resolution": "2k",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "action": "generate",
    "prompt": "从白天过渡到夜晚，灯光逐盏亮起",
    "first_frame_image": "https://cdn.example.com/day.jpg",
    "last_frame_image": "https://cdn.example.com/night.jpg",
    "duration": 10,
    "resolution": "768p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "action": "generate",
    "prompt": "沿用参考视频的运镜节奏，把场景换成雪山",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "video_urls": ["https://cdn.example.com/reference.mp4"],
    "audio_urls": ["https://cdn.example.com/bgm.mp3"],
    "duration": 12,
    "resolution": "2k"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "action": "generate",
    "prompt": "参考图里的角色走进参考视频的街景，镜头跟随",
    "image_urls": [
      "https://cdn.example.com/character.jpg",
      "https://cdn.example.com/outfit.jpg"
    ],
    "video_urls": ["https://cdn.example.com/street.mp4"],
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-regeneration",
    "action": "regenerate",
    "ref_task_id": "task-wave1788783825b950188816"
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。 接着往下做：先用 minimax-h3 以 resolution: "768p" 生成一段视频，任务 completed 后，把返回的 task_id 填进 minimax-h3-regeneration 的 ref_task_id，得到同一段内容的原生 2K 版本。ref_task_id 是本平台的任务 ID，不是上游 ID；提示词与参考素材取自源任务，不用重复提交。

请求参数

string

必填

minimax-h3、minimax-h3-max 或 minimax-h3-regeneration。

string

默认值:"generate"

generate：minimax-h3 与 minimax-h3-max 的唯一动作
regenerate：minimax-h3-regeneration 的唯一动作，需要 ref_task_id

string

必填

画面描述，generate 必填，带参考素材时也必填。

integer

必填

视频时长（秒），整数，generate 必填。minimax-h3 取 4–15，minimax-h3-max 取 5–15。

string

输出分辨率：

minimax-h3：768p 或 2k，默认 2k；用 minimax-h3-regeneration 再生成的前提是源任务为 768p
minimax-h3-max：480p、768p 或 1080p，默认 768p

string

画面比例：21:9、16:9、4:3、1:1、3:4、9:16。带首帧或尾帧时画面比例由图片决定。

string[]

参考图片 URL 数组，最多 9 张。每一张都按参考图处理，不会按张数被当成首帧或尾帧。

string

首帧图片 URL，作为视频的起始画面。不能与 image_urls、video_urls、audio_urls 混用。

string

尾帧图片 URL，与 first_frame_image 配合做「从 A 变到 B」。不能与 image_urls、video_urls、audio_urls 混用。

string[]

参考视频 URL 数组，提供运镜、节奏与风格参考。最多 3 段，总时长不超过 15 秒，帧率 23.976–60 fps；minimax-h3-max 单段 2–15 秒。

string[]

参考音频 URL 数组，最多 3 段，总时长不超过 15 秒。

minimax-h3：必须与参考图片一起提供
minimax-h3-max：必须与参考图片或参考视频一起提供；单段 2–15 秒

array

带角色的图片数组，每项 {url, role}，role 取 first_frame、last_frame 或 reference_image。最多 2 项，不能与 image_urls 同时使用，更多参考图用 image_urls。仅 minimax-h3-max。

boolean

默认值:"false"

输出添加水印。minimax-h3-max 的 1080p 不接受这个参数。

string

已完成的 minimax-h3 任务 ID，只在 minimax-h3-regeneration 的 regenerate 动作下使用，且必填。源任务必须是同账号下已成功的 minimax-h3 generate 任务，分辨率为 768p。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。 minimax-h3 与 minimax-h3-max 不接受 seed、n、negative_prompt、quality 和 generate_audio。minimax-h3-regeneration 只接受 model 与 ref_task_id，其余参数从源任务继承。以上之外的参数会返回 400，不计费。

限制

模型	条件	限制
`minimax-h3` `minimax-h3-max`	`action: "generate"`	必须提供提示词。
`minimax-h3`	`action: "generate"`	视频生成必须明确提供时长。
`minimax-h3`	传 `first_frame_image`	首尾帧模式不能与多模态参考混用。
`minimax-h3`	传 `audio_urls`	参考音频必须与参考图片一起提供。
`minimax-h3-max`	传 `first_frame_image` 或 `last_frame_image`	首尾帧模式不能与多模态参考混用。
`minimax-h3-max`	传 `audio_urls`，未传参考图片	参考音频必须与参考图片或参考视频一起提供。
`minimax-h3-max`	每次请求	参考视频、参考音频各最多 3 段；image_with_roles 最多 2 项。
`minimax-h3-max`	传 `image_with_roles`	image_with_roles 不能与 image_urls 同时使用，参考图请用 image_urls 传。
`minimax-h3-max`	`resolution: "1080p"`	1080p 不支持水印参数，请不要传 watermark。
`minimax-h3-regeneration`	`action: "regenerate"`	再生成必须提供已完成的本地 H3 任务 ID，且源任务须为 768p 输出（generate 时显式传 resolution=768p）。

项目	`minimax-h3`	`minimax-h3-max`
时长	4–15 秒	5–15 秒
参考图片	最多 9 张	最多 9 张
参考视频	最多 3 段，总时长 ≤ 15 秒	最多 3 段，单段 2–15 秒，总时长 ≤ 15 秒
参考音频	最多 3 段，总时长 ≤ 15 秒	最多 3 段，单段 2–15 秒，总时长 ≤ 15 秒

计费

minimax-h3 与 minimax-h3-max 按分辨率档 × 秒数计费：每个分辨率档一个每秒单价，乘以 duration。另外两个维度只在用到时才计：

参考视频：带 video_urls 时，输出秒按同分辨率的参考档单价计，参考视频的实际总秒数再按输入秒单价计一笔；读不到参考视频时长时按 15 秒计。
参考图片：image_urls 前若干张不加价（minimax-h3 前 5 张，minimax-h3-max 前 2 张），之后每张按固定价加收。首帧、尾帧和参考音频不单独计费。

minimax-h3-regeneration 用同一套口径，单价按 2k 档，计费时长与参考素材取自 ref_task_id 指向的源任务，源任务里的参考视频与参考图片在再生成时再计一次。

各模型的单价见 GET /v1/models 返回的 price_config，或控制台「模型市场」。看这一单实际花了多少：任务响应里的 cost（整数 quota，500,000 quota = 1 USD）。

只有成功出片才计费。任务失败、取消，或没有返回可用视频时，全额退款。最终费用以任务响应里的 cost 为准，它是整数 quota 不是美元。

响应

任务完成

{
  "task_id": "task-wave1788783825b950188816",
  "model": "minimax-h3",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1788783825,
  "completed_at": 1788783934,
  "result": {
    "videos": [
      {
        "url": ["https://cdn.example.com/result.mp4"],
        "expires_at": 1789089508
      }
    ]
  },
  "billing_status": "settled",
  "cost": 144000,
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1788783825b950188816",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1788783825b950188816/cancel"
  }
}

result.videos 返回成片，expires_at 是链接过期时间（Unix 秒），过期前把文件转存到自己的存储。minimax-h3-max 与再生成任务的响应形状相同。完整字段说明见查询任务状态。

可用模型

模型 ID	动作	分辨率	时长（秒）	输入
`minimax-h3`	`generate`	`768p` `2k`	4–15	文本、参考图、首尾帧、参考视频、参考音频
`minimax-h3-max`	`generate`	`480p` `768p` `1080p`	5–15	文本、参考图、首尾帧、参考视频、参考音频
`minimax-h3-regeneration`	`regenerate`	`2k`	取自源任务	已完成的 `minimax-h3` 768P 任务 ID

相关文档

MiniMax H3

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "image_with_roles": [
    {}
  ],
  "watermark": true,
  "ref_task_id": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "image_urls": ["<string>"],
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "video_urls": ["<string>"],
    "audio_urls": ["<string>"],
    "image_with_roles": [{}],
    "watermark": True,
    "ref_task_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    image_urls: ['<string>'],
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    video_urls: ['<string>'],
    audio_urls: ['<string>'],
    image_with_roles: [{}],
    watermark: true,
    ref_task_id: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"watermark\": true,\n  \"ref_task_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"watermark\": true,\n  \"ref_task_id\": \"<string>\"\n}")
  .asString();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

限制

计费

响应

可用模型

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​可用模型

​相关文档

快速开始

请求参数

限制

计费

响应

可用模型

相关文档