MiniMax H3 Lite API

与 minimax-h3 同一个 MiniMax H3 多模态视频模型,走低价渠道按秒计费:480P $0.01/秒、768P $0.02/秒,1-15 秒任意整秒。一个接口按输入自动分流 —— 只给提示词是文生视频,加参考图锁人物 / 产品 / 风格,加参考音频驱动声音和口型,或者传首尾帧做插补镜头。参考图和音频免费。不接参考视频、没有 2K。

价格(按秒)

分辨率	每秒	5s	10s	15s
480P	$0.01	$0.05	$0.10	$0.15
768P(默认)	$0.02	$0.10	$0.20	$0.30

按实际请求的秒数收费,1-15 秒任意整秒。参考图(最多 9 张)和参考音频(最多 3 段)不另收费。仅成功扣费、失败退款。

和 minimax-h3 的取舍:同一个模型,Lite 在 768P 上是五分之一的价钱($0.02 vs $0.097/秒),但没有原生 2K、不接参考视频、画幅只有 16:9 / 9:16。要 2K 交付或复刻参考视频的运镜,用 minimax-h3。

认证

所有请求在 Header 携带 API Key:

Authorization: Bearer YOUR_API_KEY

生成视频

POST/api/v1/video/generations·GET/api/v1/video/generations?task_id=

# Text-to-video (prompt only). Add images / audio_list / first+last frame for the other modes.
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-lite",
    "prompt": "A girl with headphones nods to the beat in a bright studio, slow push-in, soft light",
    "duration": 5,
    "resolution": "768p",
    "ratio": "16:9"
  }'

# Reference images + reference audio (audio drives voice and lip movement; needs >= 1 image)
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-lite",
    "prompt": "The girl in Picture 1 sings along to Audio 1, gentle head movement, studio light",
    "images": ["https://example.com/ref1.png", "https://example.com/ref2.png"],
    "audio_list": ["https://example.com/voice.wav"],
    "duration": 10,
    "resolution": "768p"
  }'

# Poll until completed (result files are kept 7 days)
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

四种模式,一个接口

不需要选模式 —— 我们按你传的字段自动分流:

文生视频 — 只传 prompt。
参考图 — prompt + images(1-9 张)。锁定人物、产品或风格;在提示词里可以用 Picture 1 / Picture 2 指代。
参考图 + 音频 — prompt + images(≥1)+ audio_list(1-3 段)。音频驱动声音和口型,提示词里用 Audio 1 指代。
首尾帧 — prompt + first_frame_url + last_frame_url(两帧都必填),不能再带 images / audio_list。只传首帧会当作 1 张参考图处理。

参数

字段	必填	类型	说明
model	是	string	minimax-h3-lite
prompt	是	string	描述画面、动作、运镜、光线和声音;最长 20000 字符。
duration	否	number	1-15 任意整秒,默认 5。按这个秒数计费。
resolution	否	string	480p($0.01/秒)或 768p($0.02/秒,默认)。没有 1080p / 2k。
ratio	否	string	16:9(横,默认)或 9:16(竖)。也接受 aspect_ratio。
images	否	string[]	参考图,最多 9 张(公网 URL 或 base64)。也接受 image_urls / reference_image_urls。免费。
audio_list	否	string[]	参考音频,最多 3 段(mp3 / wav,URL 或 base64),需要至少一张参考图。也接受 audio_urls / reference_audio_urls。免费。
first_frame_url	否	string	首帧。与 last_frame_url 一起传即首尾帧模式;单独传当作 1 张参考图。
last_frame_url	否	string	尾帧。必须和 first_frame_url 一起传。
callback_url	否	string	任务完成时我们向该地址 POST 结果;不传就轮询 GET 查询。

说明

异步:创建返回 taskId,轮询 GET /v1/video/generations?task_id= 直到 completed,或传 callback_url。实测 480P·3s 约 1.5 分钟,768P·5s 约 2.5 分钟,768P·10s 约 4.5 分钟,768P·15s 约 8 分钟,外加排队。结果文件保留 7 天后自动删除,请及时下载或转存。
不接参考视频:带 video_list / video_urls 的请求在创建时返回明确的 400,不会静默丢掉后照常扣费。需要动作迁移请用 minimax-h3。
参数错误(时长不在 1-15、分辨率或比例不在枚举里、超过 9 图 / 3 音频、只传尾帧、首尾帧混参考素材)都在创建时同步返回 400,不建任务、不扣费。
字段名与 minimax-h3 完全一致,两者之间切换只改 model 一个字段。

试一试:Playground

常见问题

MiniMax H3 Lite 多少钱?

apimodels.app 按秒计费:480P $0.01/秒、768P $0.02/秒,1-15 秒任意整秒 —— 768P 10 秒 $0.20。参考图和音频免费。仅成功扣费,失败退款。

怎么调用 MiniMax H3 Lite API?

调 POST /api/v1/video/generations,model 设 minimax-h3-lite,传 prompt。可选 duration 1-15(默认 5)、resolution 480p 或 768p(默认 768p)、ratio 16:9 或 9:16、images(≤9)、audio_list(≤3,需配图)或 first_frame_url + last_frame_url。轮询 GET /api/v1/video/generations?task_id=xxx 或传 callback_url。apimodels.app 一把 API Key 通调全站模型。

minimax-h3-lite 和 minimax-h3 有什么区别?

同一个 MiniMax H3 模型。Lite 在 768P 上只要五分之一的价钱($0.02/秒 vs $0.097/秒),但没有原生 2K、不接参考视频、画幅只有 16:9 / 9:16。样片、社媒短片、跑量选 Lite;要 2K 交付或复刻参考视频运镜选 minimax-h3。