大模型服务平台 TokenHub MiniMax 调用指南

概述
MiniMax 视频（海螺视频）是 MiniMax 推出的视频生成模型系列，支持文生视频、图生视频（首帧 / 首尾帧）、多模态参考生视频等能力，具备运镜指令控制、2K 直出、原生立体声等特性。
本文介绍如何通过 TokenHub 调用 MiniMax 的三款视频模型：minimax-video-v2.3、minimax-video-v2.3-fast、minimax-video-h3。
说明：
MiniMax 视频在 TokenHub 上统一通过一个提交端点调用：POST /v1/wand/minimax-video/generation。其中 v2.3 / v2.3-fast 使用扁平参数（prompt、first_frame_image 等）；h3 使用 content 多模态数组传参，详见各接口章节。
前提条件
已 注册腾讯云 账号并开通 TokenHub 服务。
已在 TokenHub 控制台 获取 API Key。
说明：
下文所有示例中的 YOUR_API_KEY 均需替换为您自己的 API Key，鉴权方式为请求头 Authorization: Bearer YOUR_API_KEY。
调用流程
视频生成为耗时任务（通常 1~3 分钟），接口采用异步调用模式，统一分两步：
1. 提交任务：调用 POST /v1/wand/minimax-video/generation，成功返回 task_id。
2. 轮询结果：携带 task_id 调用 查询任务结果 接口，直至任务状态为成功，从结果中获取视频地址。
注意：
所有接口响应均包含 request_id（顶层，用于排查问题）；查询接口额外返回 usage（用量消耗，含 usage.total_tokens）。任务状态枚举以实际返回为准：v2.3 / v2.3-fast 参照官方为 Preparing / Queueing / Processing / Success / Fail；h3 参照官方为 queued / running / succeeded / failed / cancelled。
模型列表
模型名称
model 参数值
支持能力
视频时长（秒）
清晰度档位
传参方式
选型建议
MiniMax-Video-v2.3
minimax-video-v2.3
文生 / 图生（首帧、首尾帧）
6 / 10（768P）；6（1080P）
768P / 1080P
扁平参数
旗舰款：物理表现与指令遵循强，支持运镜指令。
MiniMax-Video-v2.3-fast
minimax-video-v2.3-fast
图生（首帧）
6 / 10（768P）；6（1080P）
768P / 1080P
扁平参数
v2.3 快速版，生成更快、批量创作成本更低；仅支持图生。
MiniMax-Video-H3
minimax-video-h3
文生 / 图生（首尾帧）/ 多模态参考生
4 ~ 15
768P / 2K
content 数组
最新旗舰：2K 直出、多模态参考（图/视频/音频）、原生立体声。
说明：
minimax-video-v2.3-fast 仅支持图生视频（首帧），不支持文生视频与尾帧。
v2.3 系列时长与分辨率联动：768P 可选 6 或 10 秒，1080P 仅支持 6 秒。
h3 的 ratio（画幅）：文生必填且不能为 adaptive；图生由输入图片决定（恒 adaptive）；多模态参考生可选。
文生视频
1. 接口描述
仅凭文本提示词生成视频。支持模型：minimax-video-v2.3（扁平参数）、minimax-video-h3（content 数组）。v2.3 支持 [指令] 运镜语法，请参见 附录：运镜指令语法。
接口： POST https://tokenhub.tencentmaas.com/v1/wand/minimax-video/generation
接口： POST https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/generation
2. 输入参数
v2.3（扁平参数）：
参数名
必选
类型
描述
model
是
string
模型名称。取值：minimax-video-v2.3
prompt
是
string
文本提示词，≤ 2000 字符。支持 [指令] 运镜语法（如 [推进]、[左摇]）。
prompt_optimizer
否
boolean
是否自动优化 prompt。默认值：true；设为 false 可进行更精确的控制。
fast_pretreatment
否
boolean
是否缩短 prompt_optimizer 的优化耗时。默认值：false。
duration
否
integer
视频时长（秒）。768P：6 或 10；1080P：仅 6。默认值：6。
resolution
否
string
视频分辨率。可选：768P（默认）/ 1080P。
aigc_watermark
否
boolean
是否在生成视频中添加 AIGC 标识水印。默认值：false。
h3（content 数组）：
参数名
必选
类型
描述
model
是
string
模型名称。取值：minimax-video-h3
content
是
array[object]
多模态输入数组，文生视频仅含一个 text 元素。子字段：type（text）、text（提示词）。
resolution
是
string
视频分辨率。可选：768P / 2K。
duration
是
integer
视频时长（秒）。可选：4 ~ 15 的整数。
ratio
是
string
画面宽高比。文生视频必填且不能为 adaptive。可选：21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16。
aigc_watermark
否
boolean
是否添加 AIGC 标识水印。默认值：false。
3. 请求示例
模型：minimax-video-v2.3
curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/minimax-video/generation' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
  "model": "minimax-video-v2.3",
  "prompt": "一只橙色小猫在窗台上看向镜头"
}'
模型：minimax-video-h3
curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/generation' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
  "model": "minimax-video-h3",
  "content": [
    {
      "type": "text",
      "text": "一只橙色小猫在窗台上看向镜头"
    }
  ],
  "resolution": "2K",
  "duration": 6,
  "ratio": "16:9"
}'
4. 输出参数
字段
类型
说明
task_id
string
生成任务的任务 ID，用于轮询查询任务状态。
request_id
string
唯一请求标识，用于排查问题。
说明：
提交接口完整响应字段以实际返回为准（官方 V1 系列响应另含 base_resp.status_code / base_resp.status_msg，0 表示成功）。
5. 响应示例
{
  "task_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d",
  "request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2"
}
6. 错误码
请求失败时返回错误码，具体错误码及处理建议请参见 附录：统一错误码。任务提交成功后，生成阶段的任务状态通过 查询任务结果 接口获取。
图生视频（首帧 / 首尾帧）
1. 接口描述
以图片为首帧（v2.3 可选尾帧）结合文本提示词生成视频。支持模型：minimax-video-v2.3、minimax-video-v2.3-fast（扁平参数）、minimax-video-h3（content 数组）。输出画幅跟随输入图片。
接口： POST https://tokenhub.tencentmaas.com/v1/wand/minimax-video/generation
接口： POST https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/generation
2. 输入参数
v2.3 / v2.3-fast（扁平参数）：
参数名
必选
类型
描述
model
是
string
模型名称。取值：minimax-video-v2.3、minimax-video-v2.3-fast
first_frame_image
是
string
首帧图片，支持公网 URL 或 Base64 图片数据（Data URL 形式，如 data:image/jpeg;base64,...）。约束：JPG / JPEG / PNG / WebP；< 20MB；短边 > 300px；宽高比 2:5 ~ 5:2。
prompt
否
string
文本提示词，≤ 2000 字符。支持 [指令] 运镜语法。
prompt_optimizer
否
boolean
是否自动优化 prompt。默认值：true。
fast_pretreatment
否
boolean
是否缩短优化耗时。默认值：false。
duration
否
integer
视频时长（秒）。768P：6 或 10；1080P：仅 6。默认值：6。
resolution
否
string
视频分辨率。可选：768P（默认）/ 1080P。
aigc_watermark
否
boolean
是否添加 AIGC 标识水印。默认值：false。
h3（content 数组）：
参数名
必选
类型
描述
model
是
string
模型名称。取值：minimax-video-h3
content
是
array[object]
多模态输入数组：1 个 text + 1~2 张 image_url（role 为 first_frame / last_frame；首帧 role 可不填）。图片约束：JPG / JPEG / PNG / WEBP / HEIC / HEIF；≤ 30MB；宽高 [256, 5760]px；宽高比 [0.4, 2.5]。
resolution
是
string
视频分辨率。可选：768P / 2K。
duration
是
integer
视频时长（秒）。可选：4 ~ 15 的整数。
ratio
否
string
画面宽高比。图生视频由输入图片决定，恒为 adaptive；传入其他值不会报错但会被忽略。
aigc_watermark
否
boolean
是否添加 AIGC 标识水印。默认值：false。
3. 请求示例
模型：minimax-video-v2.3-fast（首帧）
curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/minimax-video/generation' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
  "model": "minimax-video-v2.3-fast",
  "first_frame_image": "https://example.com/input.jpg"
}'
模型：minimax-video-h3（首尾帧）
curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/generation' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
  "model": "minimax-video-h3",
  "content": [
    {
      "type": "text",
      "text": "从首帧自然过渡到尾帧"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/start.jpg" },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/end.jpg" },
      "role": "last_frame"
    }
  ],
  "resolution": "768P",
  "duration": 6
}'
4. 输出参数
同 文生视频 输出参数。
5. 响应示例
{
  "task_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d",
  "request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2"
}
6. 错误码
请求失败时返回错误码，具体错误码及处理建议见 附录：统一错误码。任务状态说明同 文生视频。
多模态参考生视频（仅 H3）
1. 接口描述
以文本 + 参考图片 / 参考视频 / 参考音频的组合为参考生成视频，仅 minimax-video-h3 支持。不可仅输入音频，须至少包含 1 个参考视频或图片。
接口： POST https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/generation
2. 输入参数
参数名
必选
类型
描述
model
是
string
模型名称。取值：minimax-video-h3
content
是
array[object]
多模态输入数组：1 个 text + 参考素材（role 为 reference_image / reference_video / reference_audio）。参考图 ≤ 9 张、参考视频 ≤ 3 段、参考音频 ≤ 3 段，素材合计 ≤ 12 个。子字段与素材约束见下表。
resolution
是
string
视频分辨率。可选：768P / 2K。
duration
是
integer
视频时长（秒）。可选：4 ~ 15 的整数。
ratio
否
string
画面宽高比。默认 adaptive（自动）；可显式指定 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16。
aigc_watermark
否
boolean
是否添加 AIGC 标识水印。默认值：false。
content 数组元素子字段：
参数名
必选
类型
描述
type
是
string
素材类型。枚举：text / image_url / video_url / audio_url。
text
条件必选
string
文本提示词，type=text 时必选（每次请求必须包含一个非空 text 项）。
image_url
条件必选
object
图片素材，type=image_url 时必选。结构 { "url": "..." }
video_url
条件必选
object
视频素材，type=video_url 时必选。结构 { "url": "..." }
audio_url
条件必选
object
音频素材，type=audio_url 时必选。结构 { "url": "..." }
role
否
string
素材用途。枚举：first_frame / last_frame / reference_image / reference_video / reference_audio。
注意：
图生视频与多模态参考生互斥：content 中出现 reference_image / reference_video / reference_audio 任一 role，就不能再出现 first_frame / last_frame，反之亦然。
参考视频：MP4 / MOV（H.264 / H.265），≤ 50MB，≤ 3 段，单段 2~15 秒、总时长 ≤ 15 秒，宽高 [256, 5760]px，帧率 [23.976, 60]。
参考音频：WAV / MP3，≤ 15MB，≤ 3 段，单段 2~15 秒、总时长 ≤ 15 秒；不可仅输入音频。
请求体总大小 ≤ 64MB，大文件请使用公网 URL，勿用 Base64。
3. 请求示例
curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/generation' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
  "model": "minimax-video-h3",
  "content": [
    {
      "type": "text",
      "text": "参考图中的角色在参考视频的场景中自然运动"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/character.jpg" },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": { "url": "https://example.com/scene.mp4" },
      "role": "reference_video"
    }
  ],
  "resolution": "768P",
  "duration": 6,
  "ratio": "16:9"
}'
4. 输出参数
同 文生视频 输出参数。
5. 响应示例
{
  "task_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d",
  "request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2"
}
6. 错误码
请求失败时返回错误码，具体错误码及处理建议见 附录：统一错误码。任务状态说明同 文生视频。
查询任务结果
1. 接口描述
各生成接口共用的任务查询方式：提交任务返回 task_id 后，通过统一的任务查询端点轮询任务状态，成功后从结果中获取视频地址。
接口： GET https://tokenhub.tencentmaas.com/v1/wand/minimax-video/tasks/{task_id}
接口： GET https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/tasks/{task_id}
说明：
路径中的 {task_id} 即提交任务时返回的 task_id（示例中以 YOUR_TASK_ID 占位）。视频生成约需 1~3 分钟，建议每 3~5 秒轮询一次。
2. 输入参数
参数名
必选
类型
描述
task_id
是
string
任务 ID（路径参数），即提交任务时返回的 task_id。
3. 请求示例
模型：minimax-video-v2.3
curl -X GET 'https://tokenhub.tencentmaas.com/v1/wand/minimax-video/tasks/YOUR_TASK_ID' \\
  -H 'Authorization: Bearer YOUR_API_KEY'
模型：minimax-video-h3
curl -X GET 'https://tokenhub.tencentmaas.com/v1/wand/minimax-video-v2/tasks/YOUR_TASK_ID' \\
  -H 'Authorization: Bearer YOUR_API_KEY'
4. 输出参数
模型：minimax-video-v2.3
字段
类型
说明
task_id
string
任务 ID。
status
string
任务状态：Preparing / Queueing / Processing / Success / Fail。
url
string
生成视频的下载地址，为临时地址，有效期 12 小时，请及时下载转存。
duration
integer
视频时长（秒）。
resolution
string
视频分辨率。
request_id
string
唯一请求标识，用于排查问题。
usage
object
用量消耗。
usage.total_tokens
integer
本次任务消耗的 token 数，用于计费/对账。
模型：minimax-video-h3
字段
类型
说明
task
object
任务对象。
task.id
string
任务 ID。
task.model
string
使用的模型名称，例如 MiniMax-H3。
task.status
string
任务状态： queued / running / succeeded / failed / cancelled。
task.task_type
string
任务类型，例如 generation（视频生成）。
task.created_at
integer
任务创建时间，Unix 时间戳（秒）。
task.updated_at
integer
任务更新时间，Unix 时间戳（秒）。
task.content
object
任务生成结果内容，成功后返回。
task.content.url
string
生成视频下载地址，临时 URL，有效期 12 小时，请及时下载保存。
task.duration
integer
视频时长，单位：秒。
task.resolution
string
视频分辨率，例如 2K。
task.ratio
string
视频宽高比例，例如 16:9。
task.usage
object
任务视频用量信息。
task.usage.input_image_count
integer
输入图片数量。
task.usage.input_seconds
integer
输入视频时长，单位：秒。
task.usage.output_seconds
integer
输出视频时长，单位：秒。
task.usage.total_seconds
integer
总计视频时长，单位：秒。
usage
object
本次请求用量消耗。
usage.total_tokens
integer
本次任务消耗的 token 数，用于计费和对账。
request_id
string
请求唯一标识，用于问题定位和排查。
注意：
查询接口的响应字段以实际返回为准（官方 V1 系列成功时另返回 file_id、video_width、video_height；h3 官方响应为 task 对象，含 content.url、usage、ratio 等字段）。
5. 响应示例
生成成功：
{
  "task_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d",
  "status": "Success",
  "url": "https://aigc-video.cos.myqcloud.com/xxx/result.mp4",
  "duration": 6,
  "resolution": "768P",
  "request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2",
  "usage": {
    "total_tokens": 102655
  }
}
6. 错误码
status
含义
处理建议
Success / succeeded
生成成功
从结果中获取视频地址。
Preparing / Queueing / Processing / queued / running
准备中 / 排队中 / 生成中
每 3~5 秒轮询一次，直至成功。
Fail / failed / cancelled
生成失败 / 已取消
查看失败原因，修改后重试；持续失败请联系技术支持并附 request_id。
请求级错误码见 附录：统一错误码。
附录
统一错误码
HTTP 状态码
业务码
错误信息
说明
200
0
success
请求成功。
401
1000
Authentication failed
Authorization 缺失或 apikey 非法。
401
1001
Authorization is empty
未携带 Authorization 头。
401
1002
Authorization is invalid
apikey 无效或已失效。
401
1003
Authorization is not yet valid
apikey 尚未生效。
401
1004
Authorization has expired
apikey 已过期。
429
1100
Account exception
账号异常（可能欠费、被封禁或被暂停）。
429
1101
Account in arrears (postpaid)
后付费账号欠费。
429
1102
Resource pack depleted or expired
资源包已用完或已过期。
403
1103
Access denied for the requested resource
请求资源无访问权限（未订阅对应模型/能力）。
400
1200
Invalid request parameters
请求参数非法（缺失必选项、类型错误、枚举越界等）。
400
1201
Invalid parameters
参数值不合法，请对照文档参数取值范围检查。
404
1202
The requested method is invalid
HTTP 方法错误。
404
1203
The requested resource does not exist
端点路径错误或资源不存在。
400
1300
Trigger the platform strategy
触发平台策略（如内容审核不通过、违规输入）。
400
1301
Trigger platform sensitive word list
命中敏感词或违规提示词。
429
1302
Too frequent API calls
调用过于频繁，触发限流。
429
1303
Concurrency or QPS exceeds the limit
并发或 QPS 超过预设配额。
400
1304
Trigger IP strategy
触发 IP 策略拦截。
500
5000
Internal server error
服务器内部错误。
503
5001
Server is temporarily unavailable
服务暂不可用（多为忙碌或维护中）。
504
5002
Server internal timeout
服务内部超时。
运镜指令语法
v2.3 / v2.3-fast 支持在 prompt 中通过 [指令] 格式添加运镜指令（h3 使用自然语言描述即可）：
左右移：[左移]、[右移]；左右摇：[左摇]、[右摇]；推拉：[推进]、[拉远]
升降：[上升]、[下降]；上下摇：[上摇]、[下摇]；变焦：[变焦推近]、[变焦拉远]
其他：[晃动]、[跟随]、[固定]
使用规则：
组合运镜：同一组 [] 内的多个指令同时生效，如 [左摇,上升]，建议组合不超过 3 个。
顺序运镜：prompt 中前后出现的指令依次生效，如 “...[推进]，然后...[拉远]”。
自然语言：也支持自然语言描述运镜，但使用标准指令能获得更准确的响应。
素材通用约束
图片（v2.3 / v2.3-fast）：JPG / JPEG / PNG / WebP；< 20MB；短边 > 300px；宽高比 2:5 ~ 5:2；支持公网 URL 或 Base64 图片数据（Data URL 形式，如 data:image/jpeg;base64,...）。
图片（h3）：JPG / JPEG / PNG / WEBP / HEIC / HEIF；≤ 30MB；宽高 [256, 5760]px；宽高比 [0.4, 2.5]；首帧 ≤ 1、尾帧 ≤ 1、参考图 ≤ 9。
视频（h3 参考视频）：MP4 / MOV（H.264 / H.265，音频 AAC / MP3）；≤ 50MB；≤ 3 段；单段 2~15 秒、总时长 ≤ 15 秒；宽高 [256, 5760]px；宽高比 [0.4, 2.5]；帧率 [23.976, 60]。
音频（h3 参考音频）：WAV / MP3；≤ 15MB；≤ 3 段；单段 2~15 秒、总时长 ≤ 15 秒。
注意：
h3 请求体总大小 ≤ 64MB，大文件请使用公网 URL，勿用 Base64。
常见问题
1. 三款模型如何选择？
通用场景、要强物理表现与指令遵循：minimax-video-v2.3（文生图生均可）。
图生场景、速度与成本优先（批量创作最高可降 50% 成本）：minimax-video-v2.3-fast（仅图生）。
要 2K 直出、多模态参考（参考图/视频/音频）、最长 15 秒：minimax-video-h3。
2. minimax-video-v2.3-fast 能用于文生视频吗？
不能。v2.3-fast 仅支持图生视频（首帧），文生视频请使用 minimax-video-v2.3 或 minimax-video-h3。
3. 时长和分辨率的组合有什么限制？
v2.3 / v2.3-fast：768P 可选 6 或 10 秒，1080P 仅支持 6 秒。
h3：时长 4~15 秒，768P / 2K 均可。
4. 生成结果视频链接会过期吗？
会过期。生成结果为临时地址，有效期 12 小时，请在任务成功后及时下载视频文件并转存到自有存储，不要长期依赖该链接。
﻿

模型名称	model 参数值	支持能力	视频时长（秒）	清晰度档位	传参方式	选型建议
MiniMax-Video-v2.3	`minimax-video-v2.3`	文生 / 图生（首帧、首尾帧）	6 / 10（768P）；6（1080P）	768P / 1080P	扁平参数	旗舰款：物理表现与指令遵循强，支持运镜指令。
MiniMax-Video-v2.3-fast	`minimax-video-v2.3-fast`	图生（首帧）	6 / 10（768P）；6（1080P）	768P / 1080P	扁平参数	v2.3 快速版，生成更快、批量创作成本更低；仅支持图生。
MiniMax-Video-H3	`minimax-video-h3`	文生 / 图生（首尾帧）/ 多模态参考生	4 ~ 15	768P / 2K	content 数组	最新旗舰：2K 直出、多模态参考（图/视频/音频）、原生立体声。

参数名	必选	类型	描述
model	是	string	模型名称。取值：`minimax-video-v2.3`
prompt	是	string	文本提示词，≤ 2000 字符。支持 `[指令]` 运镜语法（如 [推进]、[左摇]）。
prompt_optimizer	否	boolean	是否自动优化 prompt。默认值：true；设为 false 可进行更精确的控制。
fast_pretreatment	否	boolean	是否缩短 prompt_optimizer 的优化耗时。默认值：false。
duration	否	integer	视频时长（秒）。768P：6 或 10；1080P：仅 6。默认值：6。
resolution	否	string	视频分辨率。可选：768P（默认）/ 1080P。
aigc_watermark	否	boolean	是否在生成视频中添加 AIGC 标识水印。默认值：false。

字段	类型	说明
task_id	string	生成任务的任务 ID，用于轮询查询任务状态。
request_id	string	唯一请求标识，用于排查问题。

status	含义	处理建议
Success / succeeded	生成成功	从结果中获取视频地址。
Preparing / Queueing / Processing / queued / running	准备中 / 排队中 / 生成中	每 3~5 秒轮询一次，直至成功。
Fail / failed / cancelled	生成失败 / 已取消	查看失败原因，修改后重试；持续失败请联系技术支持并附 request_id。

HTTP 状态码	业务码	错误信息	说明
200	0	success	请求成功。
401	1000	Authentication failed	Authorization 缺失或 apikey 非法。
401	1001	Authorization is empty	未携带 Authorization 头。
401	1002	Authorization is invalid	apikey 无效或已失效。
401	1003	Authorization is not yet valid	apikey 尚未生效。
401	1004	Authorization has expired	apikey 已过期。
429	1100	Account exception	账号异常（可能欠费、被封禁或被暂停）。
429	1101	Account in arrears (postpaid)	后付费账号欠费。
429	1102	Resource pack depleted or expired	资源包已用完或已过期。
403	1103	Access denied for the requested resource	请求资源无访问权限（未订阅对应模型/能力）。
400	1200	Invalid request parameters	请求参数非法（缺失必选项、类型错误、枚举越界等）。
400	1201	Invalid parameters	参数值不合法，请对照文档参数取值范围检查。
404	1202	The requested method is invalid	HTTP 方法错误。
404	1203	The requested resource does not exist	端点路径错误或资源不存在。
400	1300	Trigger the platform strategy	触发平台策略（如内容审核不通过、违规输入）。
400	1301	Trigger platform sensitive word list	命中敏感词或违规提示词。
429	1302	Too frequent API calls	调用过于频繁，触发限流。
429	1303	Concurrency or QPS exceeds the limit	并发或 QPS 超过预设配额。
400	1304	Trigger IP strategy	触发 IP 策略拦截。
500	5000	Internal server error	服务器内部错误。
503	5001	Server is temporarily unavailable	服务暂不可用（多为忙碌或维护中）。
504	5002	Server internal timeout	服务内部超时。

MiniMax 调用指南

本页目录：

概述

前提条件

调用流程

模型列表

文生视频

1. 接口描述

2. 输入参数

v2.3（扁平参数）：

h3（content 数组）：

3. 请求示例

模型：minimax-video-v2.3

模型：minimax-video-h3

4. 输出参数

5. 响应示例

6. 错误码

图生视频（首帧 / 首尾帧）

1. 接口描述

2. 输入参数

3. 请求示例

4. 输出参数

5. 响应示例

6. 错误码

多模态参考生视频（仅 H3）

1. 接口描述

2. 输入参数

3. 请求示例

4. 输出参数

5. 响应示例

6. 错误码

查询任务结果

1. 接口描述

2. 输入参数

3. 请求示例

4. 输出参数

5. 响应示例

6. 错误码

附录

统一错误码

运镜指令语法

素材通用约束

常见问题

1. 三款模型如何选择？

2. minimax-video-v2.3-fast 能用于文生视频吗？

3. 时长和分辨率的组合有什么限制？

4. 生成结果视频链接会过期吗？