描述你想生成的短视频，选择 5–15 秒，即可使用 MiniMax H3 Fast 生成 480P 视频。只用文字时，请选择横屏或竖屏画面，例如 16:9 或 9:16。也可以提供符合要求的图片或视频片段作为参考。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
MiniMax
描述你想生成的短视频，选择 5–15 秒，即可使用 MiniMax H3 Fast 生成 480P 视频。只用文字时，请选择横屏或竖屏画面，例如 16:9 或 9:16。也可以提供符合要求的图片或视频片段作为参考。
用文字描述场景，即可生成 5–15 秒、480P 的 MiniMax H3 Fast 短视频。也可以提供符合要求的图片或视频片段作为参考。完成后会得到视频链接，请在链接过期前保存视频。
生成一段[5 秒]短视频，画面是[一只小纸船漂过平静的池塘]，镜头[缓慢跟随小纸船]，采用[横屏画面]。
用作视频开头或结尾的图片，不能与另外提供的参考图片、视频或音频混用。音频不能单独作为参考。生成后的视频链接会过期，请尽快打开并保存视频。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
视频生成请求body | object | 必填 | 必填请求对象，包含模型、内容、分辨率和时长。画面比例与素材要求由生成模式决定。
|
视频模型body.model | string | 必填 | 必填字符串，用于选择视频生成模型，固定为 MiniMax-H3-Fast。
|
画面比例body.ratio | string | 选填 | 画面宽高比例，可选 adaptive、21:9、16:9、4:3、1:1、3:4 或 9:16。仅用文字时必须明确选择非 adaptive 的比例。图生视频按图片决定比例并解析为 adaptive；参考素材模式默认 adaptive，也可明确指定支持的比例。
|
提示词与素材条目body.content | array | 必填 | 必填数组，须恰好包含一个非空文字条目。可添加首尾帧图片，或添加参考图片、视频与音频；这两组素材不能混用。
|
[]body.content[] | object | — | |
视频描述body.content[].textoneOf · 1 | string | — | 单个 text 条目的必填字段：1–7,000 字符的非空字符串，用于描述预期视频。即使提供参考素材，也必须保留文字描述。
|
内容类型body.content[].typeoneOf · 1 | string | — | 必填类型标签，可为 text、image_url、video_url 或 audio_url。每个类型均有对应的必填文字或素材链接字段。
|
素材角色body.content[].roleoneOf · 2 | string | — | 图片可用 first_frame、last_frame 或 reference_image；单张图片未指定角色时默认 first_frame，last_frame 必须搭配 first_frame。参考视频和音频分别必填 reference_video 与 reference_audio。参考图片最多九张，视频与音频分别最多三个片段，音频不能作为唯一参考。
|
内容类型body.content[].typeoneOf · 2 | string | — | 必填类型标签，可为 text、image_url、video_url 或 audio_url。每个类型均有对应的必填文字或素材链接字段。
|
图片来源body.content[].image_urloneOf · 2 | object | — | image_url 条目的必填链接对象。首尾帧提供视频的图片边界，reference_image 提供视觉参考素材。
|
图片链接或数据 URIbody.content[].image_url.urloneOf · 2 | string | — | 非空公开 HTTPS 链接或数据 URI；不支持 mm_file://。图片支持 JPG/JPEG/PNG/WEBP/HEIC/HEIF，单张不超过 30 MB，每边 256–5,760 像素，宽高比为 0.4–2.5。整个请求体不超过 64 MB。
|
素材角色body.content[].roleoneOf · 3 | string | — | 图片可用 first_frame、last_frame 或 reference_image；单张图片未指定角色时默认 first_frame，last_frame 必须搭配 first_frame。参考视频和音频分别必填 reference_video 与 reference_audio。参考图片最多九张，视频与音频分别最多三个片段，音频不能作为唯一参考。
|
内容类型body.content[].typeoneOf · 3 | string | — | 必填类型标签，可为 text、image_url、video_url 或 audio_url。每个类型均有对应的必填文字或素材链接字段。
|
视频参考来源body.content[].video_urloneOf · 3 | object | — | video_url 条目的必填链接对象，搭配 reference_video 角色使用。视频参考属于参考素材模式，不能加入首尾帧模式。
|
参考视频链接body.content[].video_url.urloneOf · 3 | string | — | 非空公开 HTTPS 链接或数据 URI，视频优先使用链接。支持 H.264 或 H.265 编码的 MP4/MOV，每段不超过 50 MB。每段 2–15 秒，视频参考总时长不超过 15 秒；不支持 mm_file://，整个请求不超过 64 MB。
|
素材角色body.content[].roleoneOf · 4 | string | — | 图片可用 first_frame、last_frame 或 reference_image；单张图片未指定角色时默认 first_frame，last_frame 必须搭配 first_frame。参考视频和音频分别必填 reference_video 与 reference_audio。参考图片最多九张，视频与音频分别最多三个片段，音频不能作为唯一参考。
|
内容类型body.content[].typeoneOf · 4 | string | — | 必填类型标签，可为 text、image_url、video_url 或 audio_url。每个类型均有对应的必填文字或素材链接字段。
|
音频参考来源body.content[].audio_urloneOf · 4 | object | — | audio_url 条目的必填链接对象，搭配 reference_audio 角色使用。音频用于视频生成中的参考素材，必须同时提供图片或视频参考。
|
参考音频链接body.content[].audio_url.urloneOf · 4 | string | — | 非空公开 HTTPS 链接或数据 URI。支持 WAV/MP3，每段不超过 15 MB；每段 2–15 秒，音频参考总时长不超过 15 秒。不支持 mm_file://，整个请求不超过 64 MB。
|
请求时长body.duration | integer | 必填 | 必填整数，表示请求的视频秒数，范围为 5–15。当前 credits 上限不等于所选时长的最终扣费。
|
输出分辨率body.resolution | string | 必填 | 必填设置，用于指定生成视频的分辨率，仅支持 480P。
|
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"model",
"content",
"resolution",
"duration"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"model": {
"type": "string",
"const": "MiniMax-H3-Fast",
"description": "模型固定为 MiniMax-H3-Fast，必填。"
},
"ratio": {
"enum": [
"adaptive",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"type": "string",
"description": "画面比例。文生视频必填且不能为 adaptive；图生视频固定按输入图像确定比例。参考生成默认 adaptive，也可指定具体比例。"
},
"content": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 7000,
"minLength": 1,
"description": "视频提示词，最多 7000 个字符；所有生成模式均必填。"
},
"type": {
"type": "string",
"const": "text"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"image_url"
],
"properties": {
"role": {
"enum": [
"first_frame",
"last_frame",
"reference_image"
],
"type": "string",
"description": "图像用途为 first_frame、与首帧配对的 last_frame，或最多 9 张 reference_image。单张未指定用途时默认为首帧。支持 JPG、JPEG、PNG、WEBP、HEIC、HEIF；每边 256 至 5760 像素，比例 0.4 至 2.5。"
},
"type": {
"type": "string",
"const": "image_url"
},
"image_url": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"minLength": 1,
"description": "公开 HTTPS 链接或 data URI，不支持 mm_file://。图像不超过 30MB，参考视频不超过 50MB，参考音频不超过 15MB，整个请求不超过 64MB；视频优先使用链接。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"video_url",
"role"
],
"properties": {
"role": {
"type": "string",
"const": "reference_video",
"description": "参考视频，仅用于参考生成，最多 3 个。支持 MP4/MOV、H.264/H.265；每段 2 至 15 秒，合计不超过 15 秒。"
},
"type": {
"type": "string",
"const": "video_url"
},
"video_url": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"minLength": 1,
"description": "公开 HTTPS 链接或 data URI，不支持 mm_file://。图像不超过 30MB，参考视频不超过 50MB，参考音频不超过 15MB，整个请求不超过 64MB；视频优先使用链接。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"audio_url",
"role"
],
"properties": {
"role": {
"type": "string",
"const": "reference_audio",
"description": "参考音频，仅用于参考生成，最多 3 个，且不能作为唯一参考。支持 WAV/MP3；每段 2 至 15 秒，合计不超过 15 秒。"
},
"type": {
"type": "string",
"const": "audio_url"
},
"audio_url": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"minLength": 1,
"description": "公开 HTTPS 链接或 data URI，不支持 mm_file://。图像不超过 30MB，参考视频不超过 50MB，参考音频不超过 15MB，整个请求不超过 64MB；视频优先使用链接。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"minItems": 1,
"description": "多模态输入。每个请求必须包含且仅包含一项非空文本。图生视频使用 first_frame/last_frame，参考生成使用 reference_image/reference_video/reference_audio，两组不可混用。"
},
"duration": {
"type": "integer",
"maximum": 15,
"minimum": 5,
"description": "视频长度，单位秒，范围 5 至 15。"
},
"resolution": {
"enum": [
"480P"
],
"type": "string",
"description": "输出分辨率，供应商 480P 报价为每秒 0.046 美元；Toolmu 以当前目录的 credits 计费。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
每种模式都用一个文字条目描述场景与运动。首尾帧定义图生视频的图片边界；参考图片、视频和音频则用于引导参考素材生成。两组素材不能混用，并须使用本工具固定的模型与分辨率。
素材大小限制分别适用于每张图片、每段视频或音频，64 MB 则限制整个请求体。公开 HTTPS 链接可避免在请求中放入大段媒体字符串。音频参考必须同时搭配图片或视频参考。
返回的 result.task 包含供应商任务 ID 与输出设置。content.url 用于获取视频，供应商状态 succeeded 表示生成完成。链接有时效，应及时保存视频。返回的 created_at 与 updated_at 分别是创建任务及最近更新状态的 Unix 秒数；供应商任务 ID 与 Toolmu 任务 ID 不同。
用量区分输入参考视频秒数、输出视频秒数及其合计，以及提交图片数与需计费的额外图片数。应将这些数值与已确认的 Toolmu 扣费分开保存。返回的 style 标签属于元数据，不是额外的请求设置。
选择[5 到 15 秒之间的时长，每次增加 1 秒]。只用文字描述时，请选择[横屏、方形或竖屏]。生成的视频清晰度有限。
生成一段[5 秒]短视频，画面是[一只小纸船漂过平静的池塘]，镜头[缓慢跟随小纸船]，采用[横屏画面]。
视频生成后，请尽快打开并保存，因为链接会过期。想让视频参考已有照片或片段，请提供[无需登录、点击后能直接打开照片或视频的链接]。只打开社交平台帖子的分享链接可能无法使用。
可以。描述画面内容，选择 5–15 秒的时长，再选择横屏或竖屏，例如 16:9 或 9:16。
可以提供能直接打开素材文件的公开链接。你可以用一张图片指定视频开头，也可以再加一张指定结尾；或者用图片、视频片段作为参考，但不要把两种用法混在一起。音频需要同时提供图片或视频。
不会。请趁链接还可用时打开并保存视频；只保存链接并不等于保存了视频文件。
实际费用会随视频时长变化。开始前请让 Agent 核对价格和预算；视频完成后，再确认实际扣费。