minimax · 文生视频

按输入素材选择生成方式，核对型号与媒体规格。

POST/v1/video/generations

异步任务

查看候选模型 ID 与规格

模型 ID	厂商	类型	说明	上下文窗口	最大输出 Token	媒体规格	价格	状态
`MiniMax-H3`	minimax	视频	通过 content 文本项创建视频任务；图片与多模态输入格式见 H3 官方参考。	—	—	查看规格型号：`MiniMax-H3` 生成方式：文生视频、图生视频、视频编辑；时长：4–15 秒（整数，H3 官方规格）；分辨率：768P / 2K（H3 官方规格）；音频生成：支持；宽高比：文生视频：21:9、16:9、4:3、1:1、3:4、9:16	查看价格型号：`MiniMax-H3` $0.0689 币种：USD；计价单位：秒起；页面折扣：9.5折；资料日期：2026-09-28 登录页面参考价登录模型广场展示价，含页面折扣；以当前账户价格和账单为准。	—

按公开标签归类，并补充模型广场资料；— 表示暂无明确资料。左右滑动查看完整表格。

生成效果示例

Headers请求头

左右滑动查看完整参数表

请求头
参数名	类型	必填	说明	默认值 / 示例
`Authorization`	string	必填	平台 API Key，使用 Bearer 认证。	示例 `Bearer YOUR_API_KEY`
`Content-Type`	string	必填	请求体编码格式。	示例 `application/json`

Request Body请求体

application/json

左右滑动查看完整参数表

参数名类型必填说明默认值 / 示例

model

string

必填

平台模型 ID，大小写需完全一致。此页仅说明 MiniMax-H3。

可选值MiniMax-H3

示例: MiniMax-H3

content

array

必填

输入内容数组。每次请求必须包含一个非空 text 项；纯文本场景只含一个 text 项。图片、视频、音频为官方多模态参考，平台组合支持见补充说明。

—

content[] 的子字段 6

参数名类型必填说明默认值 / 示例

type

string

必填

内容项类型，决定填写 text 或同名媒体对象。

可选值textimage_urlvideo_urlaudio_url

—

text

string

可选

条件必填：type=text 时必填，且不能为空，最长 7000 字符。媒体项不填写 text；每个请求必须包含一个文本项。

—

image_url

object

可选

条件必填：type=image_url 时提供同名对象；不能直接填写字符串。

—

content[].image_url 的子字段 1

content[].image_url 子字段
参数名	类型	必填	说明	默认值 / 示例
`url`	string	必填	该媒体对象中的素材地址。平台映射待确认；官方格式和限制见折叠补充。	—

video_url

object

可选

条件必填：type=video_url 时提供同名对象；不能直接填写字符串。

—

content[].video_url 的子字段 1

content[].video_url 子字段
参数名	类型	必填	说明	默认值 / 示例
`url`	string	必填	该媒体对象中的素材地址。平台映射待确认；官方格式和限制见折叠补充。	—

audio_url

object

可选

条件必填：type=audio_url 时提供同名对象；不能直接填写字符串。

—

content[].audio_url 的子字段 1

content[].audio_url 子字段
参数名	类型	必填	说明	默认值 / 示例
`url`	string	必填	该媒体对象中的素材地址。平台映射待确认；官方格式和限制见折叠补充。	—

role

string

可选

媒体用途。单张首帧图片可省略并默认为 first_frame；首尾帧分别填写 first_frame、last_frame；参考素材填写对应 reference_*。首尾帧与参考场景互斥。

可选值first_framelast_framereference_imagereference_videoreference_audio

—

resolution

string

必填

H3 输出分辨率，保留官方大写写法；最终尺寸以生成文件为准。

可选值768P2K

示例: 2K

duration

integer

必填

生成时长（秒），必填，取整数 4–15。

示例: 5

ratio

string

可选

条件必填：纯文本 content 仅含 text 时必填具体比例，不能使用 adaptive。官方图生视频按图片自适应，传入其他比例也按 adaptive 处理；参考生视频可省略并默认 adaptive，也可指定具体比例。

可选值adaptive21:916:94:31:13:49:16

示例: 16:9

使用说明

MiniMax-H3 使用 content[].text 提供提示词，无需重复填写顶层 prompt；纯文本请求保留一个非空 text 项。
文生视频 ratio 必填且不能为 adaptive；图生与参考生视频的官方条件见参数表和折叠补充。
图片与多模态输入的官方格式见折叠补充；平台映射待确认。
创建受理不等于生成完成。保存任务 ID，通过平台 GET /v1/video/generations/{task_id} 查询同一任务；以任务终态和生成文件核对结果，避免重复创建。
平台查询读取 data.status 与 data.result_url；官方原生查询读取 task.status 与 task.content.url，两者不要混用。
本页视频示例为 2560×1440、24 fps，带 AAC 音轨；请求及原生响应 duration=5，文件时长约 5.167 秒，最终时长以媒体文件为准。

调用示例

curl --request POST \
  --url https://ai.kedang.net/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "16:9"
}'

# pip install requests
import requests

url = 'https://ai.kedang.net/v1/video/generations'
headers = {'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}
payload = {'model': 'MiniMax-H3',
 'content': [{'type': 'text',
              'text': '史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。'}],
 'resolution': '2K',
 'duration': 5,
 'ratio': '16:9'}

response = requests.request(
    'POST', url, headers=headers, timeout=120, json=payload
)
response.raise_for_status()
print(response.json())

// Node.js 18+ · 保存为 example.mjs 后运行

const headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
};
const payload = {
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "16:9"
};

const response = await fetch("https://ai.kedang.net/v1/video/generations", {
  method: "POST",
  headers,
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify(payload),
});
if (!response.ok) {
  throw new Error(`${response.status}: ${await response.text()}`);
}
console.log(await response.json());

package main

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

func main() {
	payload := strings.NewReader("{\n  \"model\": \"MiniMax-H3\",\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": \"史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。\"\n    }\n  ],\n  \"resolution\": \"2K\",\n  \"duration\": 5,\n  \"ratio\": \"16:9\"\n}")
	req, err := http.NewRequest("POST", "https://ai.kedang.net/v1/video/generations", payload)
	if err != nil { log.Fatal(err) }
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{Timeout: 120 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()
	data, err := io.ReadAll(resp.Body)
	if err != nil { log.Fatal(err) }
	if resp.StatusCode >= 400 { log.Fatalf("%s: %s", resp.Status, data) }
	fmt.Println(string(data))
}

响应示例

200

响应脱敏说明

任务 ID、请求 ID、数字记录 ID、账户与通道信息已替换为占位值；视频地址使用 example.com 占位，请使用实际返回地址。

{
  "id": "TASK_ID",
  "task_id": "TASK_ID",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "queued",
  "progress": 0,
  "created_at": 1793186138
}

任务查询示例

将任务 ID 替换为创建接口返回的 ID。

curl --request GET \
  --url https://ai.kedang.net/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

任务查询响应

200

根据任务状态判断生成进度，完成后读取结果地址。

响应脱敏说明

任务 ID、请求 ID、数字记录 ID、账户与通道信息已替换为占位值；视频地址使用 example.com 占位，请使用实际返回地址。

{
  "code": "success",
  "message": "",
  "data": {
    "id": 0,
    "created_at": 1793186138,
    "updated_at": 1793186336,
    "task_id": "TASK_ID",
    "platform": "[已脱敏]",
    "user_id": "[已脱敏]",
    "group": "[已脱敏]",
    "channel_id": "[已脱敏]",
    "quota": "[已脱敏]",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://example.com/generated-video.mp4",
    "request_id": "REQUEST_ID",
    "submit_time": 1793186138,
    "start_time": 1793186271,
    "finish_time": 1793186336,
    "progress": "100%",
    "properties": {
      "input": "",
      "upstream_model_name": "[已脱敏]",
      "origin_model_name": "[已脱敏]"
    },
    "data": {
      "task": {
        "id": "TASK_ID",
        "model": "MiniMax-H3",
        "ratio": "16:9",
        "usage": {
          "total_tokens": 260390,
          "input_seconds": 0,
          "prompt_tokens": 0,
          "total_seconds": 5,
          "output_seconds": 5,
          "completion_tokens": 260390,
          "input_image_count": 0
        },
        "status": "succeeded",
        "content": {
          "url": "https://example.com/generated-video.mp4"
        },
        "duration": 5,
        "task_type": "generation",
        "created_at": 1793186137,
        "resolution": "2K",
        "updated_at": 1793186298
      }
    }
  }
}

平台任务响应

创建和查询使用不同的响应结构。查询同一个任务，确认 data.status=SUCCESS 后读取 data.result_url；不要只凭 HTTP 200 或 code=success 判断视频完成。

查看创建与查询响应字段

左右滑动查看完整参数表

H3 平台任务响应字段
字段	类型	说明
创建：id / task_id	string	返回的任务 ID。保存 task_id，后续只查询此任务。
创建：object / model	string	对象类型 video 与模型 MiniMax-H3。
创建：status / progress	string / number	受理响应为 queued、0，表示已排队，尚未生成完成。
创建：created_at	integer	创建时间，Unix 秒级时间戳。
查询：code / message	string	查询请求的业务状态与说明；code=success 不等于视频已经生成成功。
查询：data.task_id	string	所查询任务的 ID。
查询：data.status	string	任务状态，例如 NOT_START、IN_PROGRESS、SUCCESS。SUCCESS 表示生成成功。
查询：data.progress	string	百分比进度，例如 100%；与创建响应的数字类型不同。
查询：data.fail_reason	string	任务失败原因；成功时可为空字符串。
查询：data.result_url	string	成功后的视频下载地址，及时下载或转存。此地址不需要携带平台 Authorization。
查询：data.submit_time / start_time / finish_time	integer	提交、开始与结束的 Unix 秒级时间戳；未开始或未结束时可为 0。
查询：data.data.task	object	返回中保留的 H3 原生任务对象；平台解析优先使用外层 data.status / data.result_url。
查询：data.data.task.resolution / duration / ratio	string / integer / string	原生返回的分辨率档位、秒数与比例，例如 2K、5、16:9；最终媒体规格以文件为准。
查询：data.data.task.usage	object	原生用量字段，包含 total_seconds、output_seconds、total_tokens 等；费用以平台账户账单为准。

响应示例保留字段结构；任务 ID、账户信息与视频地址已替换为占位值。

MiniMax-H3 官方多模态参数与限制

以下依据官方创建文档整理，仅说明 MiniMax-H3 的原生格式。图片、多模态输入、原生媒体地址形式和可选回调的平台映射待确认。

content 输入组合

每次请求须包含一个非空 type=text 项，text 最长 7000 字符。以下仅为 content JSON 参数片段，不含模型、接口地址或鉴权，不能直接作为完整平台请求。https://example.com/… 是需替换的公开素材地址占位符。

首帧图片

{
  "content": [
    {
      "type": "text",
      "text": "镜头缓慢推进，保持主体外观一致。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.png"
      },
      "role": "first_frame"
    }
  ]
}

首尾帧图片

{
  "content": [
    {
      "type": "text",
      "text": "镜头缓慢推进，保持主体外观一致。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.png"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last-frame.png"
      },
      "role": "last_frame"
    }
  ]
}

多模态参考

{
  "content": [
    {
      "type": "text",
      "text": "参考图片1的主体外观、视频1的动作和音频1的声音，生成连贯镜头。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference-image.png"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/reference-video.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.com/reference-audio.mp3"
      },
      "role": "reference_audio"
    }
  ]
}

组合与比例规则

首帧／首尾帧与多模态参考互斥；first_frame/last_frame 不可与 reference_image/reference_video/reference_audio 混用。
单张首帧图片的 role 可省略；首尾帧分别标记 first_frame 与 last_frame。参考素材使用对应的 reference_*。
纯文本输入必须指定具体比例：21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16，不能用 adaptive。首帧／首尾帧按输入图片自适应；参考生视频默认 adaptive，也可指定具体比例。

官方输入媒体限制

左右滑动查看完整参数表

MiniMax-H3 官方媒体规格
输入	格式	限制
图片 image_url	JPG / JPEG / PNG / WEBP / HEIC / HEIF	单张 ≤30 MB；首帧 ≤1、尾帧 ≤1、参考图 ≤9；宽高各 256–5760 px；宽高比 0.4–2.5。
视频 video_url（仅参考场景）	MP4 / MOV；视频 H.264/AVC、H.265/HEVC；音频 AAC、MP3	单段 ≤50 MB；≤3 段；每段 2–15 秒，合计 ≤15 秒；宽高各 256–5760 px；宽高比 0.4–2.5；23.976–60 FPS。
音频 audio_url（仅参考场景）	WAV / MP3	单段 ≤15 MB；≤3 段；每段 2–15 秒，合计 ≤15 秒。

总请求体 ≤64 MB，大文件优先使用公开 URL。官方原生媒体对象的 url 支持公网 URL、mm_file://{file_id} 或对应模态的 Base64 Data URI；这些原生地址形式不代表平台已支持文件映射或 Base64 透传。

官方可选字段

左右滑动查看完整参数表

官方原生可选字段
参数名	类型	必填	说明	默认值 / 示例
`callback_url`	string	可选	官方原生任务状态回调地址。服务端先发送含 challenge 的验证请求，需在 3 秒内原样返回；验证后 POST 状态更新，正文结构与官方查询响应一致。平台回调映射待确认。	—
`aigc_watermark`	boolean	可选	官方原生 AIGC 标识水印开关。平台透传规则待确认。	默认值 `false`

任务与响应范围

官方原生创建返回 task_id，查询返回 task 包装；官方成功视频地址为 task.content.url，状态为 queued / running / succeeded / failed / cancelled。平台查询包装在 data 中，读取 data.status 与 data.result_url。

官方查询仅支持近 7 天任务；这一原生保留期不代表平台的结果保留政策。视频地址可能有时效，完成后及时下载或转存。

核对日期：2026-10-28。官方创建参数 · 官方任务查询