提供一段场景提示词，选择 5–15 秒的整数时长，明确设置 480P 或 768P，并使用 MiniMax-H3-Max-Turbo 生成视频，通过下载链接获取文件。纯文字模式须明确指定画面比例；图生视频可提供首帧及可选的配对尾帧。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
MiniMax
提供一段场景提示词，选择 5–15 秒的整数时长，明确设置 480P 或 768P，并使用 MiniMax-H3-Max-Turbo 生成视频，通过下载链接获取文件。纯文字模式须明确指定画面比例；图生视频可提供首帧及可选的配对尾帧。
提供一段非空场景提示词、MiniMax-H3-Max-Turbo 模型、480P 或 768P 分辨率与 5–15 秒时长，生成短视频并通过返回的链接获取文件。纯文字模式明确指定画面比例；图生视频可提供首帧及可选的配对尾帧。将任务状态和返回的视频设置与文件一并保留。
请把这个想法做成一段短视频：[一片黄叶沿着安静的溪流漂动]。镜头[缓慢跟随黄叶]。视频时长[5 秒]，画面方向[横屏]，选择[标准画质]。
尾帧必须搭配首帧，不支持参考图片、参考视频或参考音频输入。帧图格式、尺寸和大小须符合当前要求。下载链接有时效，应及时保存视频文件。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
视频生成输入body | object | 必填 | 必填对象，包含固定模型、场景内容、所选分辨率和时长，以及模式需要的画面比例或帧图。
|
生成模型body.model | string | 必填 | 指定本次视频请求的模型，必填字符串为 MiniMax-H3-Max-Turbo。
|
视频宽高比body.ratio | string | 选填 | 可选 adaptive、21:9、16:9、4:3、1:1、3:4 或 9:16。纯文字视频须明确选择非 adaptive 的值；使用帧图时由图片决定比例，请求解析为 adaptive。
|
提示词与帧图条目body.content | array | 必填 | 必填列表，恰好包含一个非空文字条目，可按需搭配首帧和配对尾帧图片。不支持参考图片、视频或音频条目。
|
[]body.content[] | object | — | |
场景提示词body.content[].textoneOf · 1 | string | — | 单个文字条目的必填字段，用 1–7,000 字符描述预期场景或动作；添加帧图后也仍然需要文字。
|
条目类型body.content[].typeoneOf · 1 | string | — | 场景描述必填类型 text，帧图必填类型 image_url；当前仅声明这两种内容分支。
|
帧图位置body.content[].roleoneOf · 2 | string | — | 用 first_frame 指定起始图片，或用 last_frame 指定与首帧配对的结束图片。单张图片不指定角色时按 first_frame 处理，不接受 reference_image 角色。
|
条目类型body.content[].typeoneOf · 2 | string | — | 场景描述必填类型 text，帧图必填类型 image_url；当前仅声明这两种内容分支。
|
帧图来源body.content[].image_urloneOf · 2 | object | — | image_url 条目的必填对象，其中的 url 提供 role 所指定位置使用的图片。
|
帧图地址body.content[].image_url.urloneOf · 2 | string | — | 非空公开 HTTPS 链接或数据 URI，大图片优先使用 HTTPS。支持 JPG/JPEG/PNG/WEBP/HEIC/HEIF，单张不超过 30 MB，每边为 256–5,760 像素，宽高比为 0.4–2.5。不支持 mm_file://。
|
请求片段时长body.duration | integer | 必填 | 必填整数，表示请求的输出秒数，可选 5–15。它是生成设置，与已确认扣费分别记录。
|
生成视频分辨率body.resolution | string | 必填 | 必填设置，可选输出视频分辨率为 480P 或 768P，没有预设分辨率，须明确选择。
|
{
"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-Max-Turbo",
"description": "模型固定为 MiniMax-H3-Max-Turbo，必填。"
},
"ratio": {
"enum": [
"adaptive",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"type": "string",
"description": "画面比例。文生视频必填且不能为 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"
],
"type": "string",
"description": "图像用途为 first_frame 或与首帧配对的 last_frame。单张未指定用途时默认为首帧。支持 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
}
]
},
"minItems": 1,
"description": "每个请求必须包含且仅包含一项非空文本；图生视频可加入 first_frame/last_frame。此模型不支持参考图像、视频或音频。"
},
"duration": {
"type": "integer",
"maximum": 15,
"minimum": 5,
"description": "视频长度，单位秒，范围 5 至 15。"
},
"resolution": {
"enum": [
"480P",
"768P"
],
"type": "string",
"description": "输出分辨率，供应商报价为 480P 每秒 0.025 美元、768P 每秒 0.04 美元；Toolmu 以当前目录的 credits 计费。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
两种支持模式都用文字描述预期场景与运动。不添加帧图时，须明确选择画面宽高比；使用 first_frame 图片时，图生视频的比例由图片决定。
用 first_frame 图片指定起始场景，再以配对的 last_frame 图片提供所需运动的结束边界；同时仍须有一个文字提示词。帧图位置用于引导生成，不表示独立参考图片输入，也不承诺逐像素还原。
返回的 task 对象标识视频生成任务。供应商任务 ID 与 Toolmu 运行 ID 分别记录；succeeded 表示完成，content.url 提供视频获取和保存地址。MiniMax 将该地址定义为有时效的下载链接，应及时保存文件。
返回的 model、resolution、duration 与 ratio 说明视频设置。MiniMax 将 created_at、updated_at 定义为任务创建及最近状态更新的 Unix 秒级时间戳。output_seconds 记录输出视频秒数，total_seconds 记录输入与输出的计量秒数合计，input_image_count 在本工具中表示提供的帧图数量。保留零值，这些用量与已确认的 Toolmu credits 扣费分别记录。
选择[5 到 15 秒，按整秒选择]，再选[标准画质（费用较低）]或[更清晰画质（费用较高）]。如果只用文字描述，还要选择[横屏]、[方形]或[竖屏]。
请把这个想法做成一段短视频：[一片黄叶沿着安静的溪流漂动]。镜头[缓慢跟随黄叶]。视频时长[5 秒]，画面方向[横屏]，选择[标准画质]。
如果视频生成后页面提供下载链接，请尽快打开并保存一份；链接之后可能失效。
不能。需提供 16:9、9:16 等支持的明确比例。图生视频则按帧图决定比例，解析为 adaptive。
不能。本工具要求 last_frame 图片必须搭配 first_frame，即使同时提供首尾帧，也仍须保留文字提示词。
这里只支持文字提示词与首帧、配对尾帧图片。视频和音频文件不是可提交的帧图，也不是支持的内容类型；图片角色也不接受 reference_image。
不能从 Turbo 名称推断完成时间或质量保证。应按任务选择支持的时长和分辨率，由 Agent 报告实际状态与已确认扣费。