# MiniMax H3 Lite API · KovAPI

> MiniMax H3 Lite 是同一个 MiniMax H3 模型，推理步数更少：更快、更便宜，画质略低，适合批量打样和试提示词。在 KovAPI 用 `minimax-h3-lite` 调用：480P、768P 两档，4–15 秒任选，按秒计费；要首帧、参考视频或 1080P，切到标准版。

网页版: https://kovapi.com/zh/model/minimax-h3-lite · 更新: 2026-11-12
价格、上限和耗时是生成这份文件时的实时值。

## 事实摘要

- 型号 ID: `minimax-h3` · `minimax-h3-lite`
- 接口: `POST https://kovapi.com/v1/videos/generations` → `GET https://kovapi.com/v1/videos/jobs/{id}`
- 时长: 4–15 秒，整数
- 分辨率: 480P / 768P，不写时 768P；传 720P 按 768P 处理
- 画面比例: 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9
- 参考素材: 最多 5 张参考图（只作参考，不作首帧）；不收参考视频和参考音频
- 声音: 每条都带原生立体声音轨（对白、音效、配乐），不能关
- 提示词: ≤ 5,000 字符
- 每秒价: 480P $0.015/秒 · 768P $0.025/秒 · 1080P $0.036/秒
- Lite 每秒价: 480P $0.005/秒 · 768P $0.0125/秒
- 成片保留: 7 天

## 一次生成画面和声音，开头结尾、人物和动作都能定

- **镜头、台词、音效按提示词的时间线走**: 按官方格式分镜头写，切换时间、台词、环境声和配乐都照提示词来。面包店这条在第 5 秒切到切面包的特写，面包师的台词一字不差，木吉他配乐也是提示词里写的。
- **定好开头，或者开头和结尾都定好**: 1 张图作首帧，成片从这张图开始拍；2 张图作首尾帧，中间的动作由模型补全。撑伞这条从收着伞的第一张图开始，最后停在撑开伞的第二张图上。
- **人物和商品照参考图，按你写的方式组合**: 参考模式最多 9 张图。眼镜广告这条放了模特、面部和眼镜三张图，按官方参考篇的结构写清每张图的作用，模特戴上这副眼镜走台步，再切到特写。
- **借参考视频的动作和运镜**: 左边是参考视频，右边是成片：卡通狐狸照着真人跳了同一段动作。参考视频也可以只提供运镜，画面里拍什么由参考图和提示词决定。参考视频的秒数也计费。
- **480P 打样，1080P 出片**: 480P / 768P / 1080P 三档，8 种画幅，4–15 秒任意整秒。先用 480P 或 [Lite](https://kovapi.com/zh/model/minimax-h3-lite) 看构图和动作，定稿再出 1080P；换档会重新生成，画面不会一模一样，下面的同题对比可以直接看差别。

## 玩法与 API 字段对照

两种玩法共用 `model`（`minimax-h3-lite`）、`prompt`、`duration`、`resolution` 和 `size`。图片一律当参考图，不用写 `image_role`。

| 玩法 | 传什么 | 得到什么 | 限制 |
| --- | --- | --- | --- |
| 文生视频 | 只传 `prompt` 和生成参数。 | 按文字生成画面和声音；台词、音效、配乐都写进提示词。 | 4–15 秒任意整数；不传 `resolution` 时 768P。 |
| 参考图 | `images` 放 1–5 张图。 | 图里的人物、商品、场景出现在新画面里，不当作首帧。 | 最多 5 张；写 `image_role: first_frame` 会被拒。 |

## MiniMax H3 价格

| 分辨率 | 标准版 | Lite | MiniMax 官方价 |
| --- | --- | --- | --- |
| 480P | $0.015/秒 | $0.005/秒 | - |
| 768P | $0.025/秒 | $0.0125/秒 | $0.08 |
| 1080P | $0.036/秒 | - | - |

- 一条的费用 = 所选档位的每秒价 ×（成片秒数 + 参考视频秒数）；参考图和参考音频不收费。在计算器里拖动「参考视频」就能算带参考视频的价格。
- MiniMax 官方价目里，H3 只有 768P 和 2K 两档，所以表里只有 768P 能和官方价对照。
- 提交时预扣，成功按同一金额结算；生成失败全额退回。批量打样想再省，可以用 [MiniMax H3 Lite](https://kovapi.com/zh/model/minimax-h3-lite)。

## 同一段提示词，五个档位各出一条

鼠标移到画面上，几条一起播放；手机上点「同步播放」。每条都是单独生成的，画面不会一模一样，比的是清晰度和细节。

### 拿铁拉花：H3 三档 + Lite 两档

同一段提示词、同样 5 秒 16:9，分别用 H3 的 1080P / 768P / 480P 和 Lite 的 768P / 480P 各跑一条。打样阶段用 480P 或 Lite 看构图和动作，定稿再出 1080P。

- 5s · 16:9
- **MiniMax H3 1080P** (按现价 $0.18): https://img.kovapi.com/i/mp-30a37c4381ec04a2ba543aab.mp4 — 最清楚：拉花纹路、奶壶反光和杯沿都看得清。
- **MiniMax H3 768P** (按现价 $0.125): https://img.kovapi.com/i/mp-2972abbc7c033fb49b25783d.mp4 — 细节略少于 1080P，画面依然干净。
- **MiniMax H3 480P** (按现价 $0.075): https://img.kovapi.com/i/mp-faf663f1a053b4a823c2ea31.mp4 — 构图和动作都看得清，放大后明显发软，适合打样。
- **MiniMax H3 Lite 768P** (按现价 $0.0625): https://img.kovapi.com/i/mp-4eda7882119d1b49c37bf0e1.mp4 — 出片快、价格低，拉花纹路明显变弱。
- **MiniMax H3 Lite 480P** (按现价 $0.025): https://img.kovapi.com/i/mp-10b056d268a7c3beaf4f26e0.mp4 — 最便宜，只适合看构图和动作。

提示词原文:

```text
integrated_multimodal_description: [Shot 1] Live-action, cinematic, a close shot of a barista's hands pouring steamed milk into a cup of espresso on a wooden counter by a sunny window. The milk forms a heart in the crema while steam curls upward, and the camera pushes in with small amplitude at slow speed toward the cup.

overall_soundscape: Milk streams into the cup, a steam wand hisses softly in the background and cafe chatter murmurs.

non_diegetic_music: N/A
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
integrated_multimodal_description（画面）：[Shot 1] 实拍，电影感，近景：洒满阳光的窗边木吧台上，咖啡师的手把打好的奶倒进一杯浓缩咖啡。奶在咖啡油脂上拉出一颗心，热气往上飘，镜头以小幅度、慢速推向杯子。

overall_soundscape（环境声）：奶流进杯子的声音，背景里蒸汽棒轻轻嘶嘶作响，咖啡馆里人声低低的。

non_diegetic_music（配乐）：N/A（无）
```

## 案例：提示词与参数

### 多镜头：面包店的第一炉面包

- 用 KovAPI 生成 · 文生视频 · 8s · 1080P · 16:9
- 按现价 $0.288
- 成片: https://img.kovapi.com/i/mp-c9751f98f2f98ea8114fa1f3.mp4

官方基础篇的文生视频示例：两个镜头，第 5 秒切到特写；面包师的台词、开窗和切面包的声音、木吉他配乐都写在提示词里，成片都照做了。背景招牌上的字是乱的，这类字要写进引号才会认真写。提示词出自 MiniMax 官方《[视频提示词写作指南](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md)》，原句照搬，成片由 KovAPI 按原提示词生成。

提示词原文:

```text
integrated_multimodal_description: [Shot 1] Live-action, cinematic, a medium-wide shot frames a baker opening the shutters of a small street bakery before sunrise. The camera pushes in with small amplitude at slow speed as the middle-aged baker with a calm, slightly raspy voice (S1) places a fresh loaf on the wooden counter and says: <d>[English] First batch of the morning.</d> [Shot 2] At 00:05.000, the camera cuts to a close-up of steam rising from the sliced bread while the baker's final words carry over from the previous shot.

overall_soundscape: Wooden shutters scrape open over a quiet street as trays clink softly inside the bakery. The doorbell rings once, followed by light footsteps and the crisp sound of bread being sliced.

non_diegetic_music: A soft acoustic-guitar pattern at a moderate tempo, joined by sparse upright-bass notes and a gentle fade at the end.
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
integrated_multimodal_description（画面与台词）：[Shot 1] 实拍，电影感，中远景：天亮前，一位面包师推开街边小面包店的窗板。镜头以小幅度、慢速向前推，嗓音平静、略带沙哑的中年面包师 (S1) 把一条刚出炉的面包放在木柜台上，说：<d>[English] First batch of the morning.</d>（今天第一炉。）[Shot 2] 在 00:05.000，镜头切到切开的面包冒着热气的特写，面包师最后那句话从上一个镜头延续过来。

overall_soundscape（环境声）：木窗板在安静的街上刮擦着推开，店里托盘轻轻碰响。门铃响了一声，接着是轻轻的脚步声和面包被切开的清脆声音。

non_diegetic_music（配乐）：中速的轻柔原声吉他，加入稀疏的低音提琴，结尾轻轻淡出。
```

### 舰桥上的跃迁

- 用 KovAPI 生成 · 文生视频 · 8s · 1080P · 16:9
- 按现价 $0.288
- 成片: https://img.kovapi.com/i/mp-66d0f99896d2e402c3af40c3.mp4

官方模型仓库里的文生视频示例：背影推镜，第 4.5 秒切到舰长面部特写，强光闪过、舰队跃迁，低频轰鸣和配乐一起起伏。提示词出自 MiniMax [H3 模型仓库](https://huggingface.co/MiniMaxAI/MiniMax-H3)说明里的示例，原句照搬，成片由 KovAPI 生成。

提示词原文:

```text
integrated_multimodal_description: [Shot 1] Cinematic, medium wide shot, pushing in slowly. In the cavernous, dimly lit bridge of a starship, sleek metallic consoles with glowing amber displays flank a massive, curved observation window. A female captain, in her late 40s with an athletic build and short silver-streaked black hair, stands in the center midground. She wears a structured, high-collared dark navy military tunic with silver chest insignias. Her back is to the camera, silhouetted against the cool, ambient starlight pouring through the thick glass. She stands perfectly still with her hands clasped tightly behind her back. Outside the window, a massive armada of jagged, dark grey dreadnoughts hovers in tight formation against a deep purple space nebula. The fleet's massive rear thrusters begin to glow with an intense, escalating bright blue light. [Shot 2] At 00:04.500, the camera cuts to a close-up of the captain's face and shakes strongly. The brilliant blue-white light from the fleet's gathering energy reflects vividly in her dark eyes. Suddenly, a blinding white flash floods through the window, completely washing out the background as the fleet jumps to hyperspace. The sheer spatial force violently jolts the bridge, causing the captain from Shot 1 to stagger slightly forward, her shoulders tensing as she visibly braces herself against the physical tremors. As the intense white light fades abruptly, leaving only the dim, empty expanse of the purple nebula reflected on her starkly lit skin, her jaw clenches, and she slowly closes her eyes in the newly emptied space.
overall_soundscape: A low, resonant hum of the ship's ambient life support systems serves as the baseline, soon drowned out by an audible, escalating, high-pitched electronic whine as the fleet outside charges its hyperdrives. A massive, deafening, bass-heavy boom and sharp crackle erupts during the blinding flash, accompanied by the loud metallic creaking, rattling, and deep thuds of the bridge's bulkheads vibrating under immense physical stress. The intense roaring impact then cuts abruptly back to a hollow, echoing room tone, leaving only the faint, steady hum of the isolated bridge.
non_diegetic_music: Cinematic space-opera orchestral score, slow tempo, featuring a solitary, mournful French horn melody over deep, sustained string dissonances that build rapidly in volume and intensity, swelling to a massive orchestral peak before snapping immediately into silence right after the jump.
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
integrated_multimodal_description（画面）：[Shot 1] 电影感，中远景，缓慢推镜。星舰舰桥空旷昏暗，两侧是亮着琥珀色屏幕的金属控制台，正前方是一面巨大的弧形观察窗。一位四十多岁的女舰长站在画面中央的中景处，体格健壮，黑色短发夹着银丝，穿着立领的深海军蓝制服，胸前有银色徽章。她背对镜头，被透过厚玻璃洒进来的冷色星光勾出剪影，双手紧握在身后，一动不动。窗外，一支由锯齿状深灰色无畏舰组成的庞大舰队在深紫色星云前列队悬停。舰队巨大的尾部推进器开始亮起越来越强的蓝光。[Shot 2] 在 00:04.500，镜头切到舰长的面部特写，并剧烈晃动。舰队聚能的蓝白强光清楚地映在她深色的眼睛里。突然，一道刺眼的白光涌进窗口，背景完全被冲白，舰队跃迁进入超空间。巨大的空间冲击力猛烈震动舰桥，第一个镜头里的舰长向前踉跄了一下，肩膀绷紧，明显在稳住身体抵抗震动。强光骤然退去，只剩下空荡荡的紫色星云映在她被照亮的脸上；她咬紧牙关，在突然变空的太空前慢慢闭上眼睛。
overall_soundscape（环境声）：舰上生命维持系统低沉、共鸣的嗡鸣是底噪，很快被窗外舰队给跃迁引擎充能时越来越尖的电子啸叫盖过。强光闪过时爆出一声震耳欲聋、低音极重的轰响和尖锐的噼啪声，舰桥舱壁在巨大压力下发出金属吱嘎、哐啷和沉闷的撞击声。剧烈的冲击声随后戛然而止，回到空洞、带回音的室内底噪，只剩空荡舰桥微弱而平稳的嗡鸣。
non_diegetic_music（配乐）：电影感的太空歌剧管弦乐，慢速：一支孤独、哀伤的圆号旋律压在深沉、持续的不协和弦乐上，音量和强度迅速攀升，涌到宏大的管弦高潮，在跃迁之后立刻断成寂静。
```

### 中文台词和霓虹招牌

- 用 KovAPI 生成 · 文生视频 · 6s · 768P · 9:16
- 按现价 $0.15
- 成片: https://img.kovapi.com/i/mp-3ea471e559f9efb09edaf873.mp4

竖屏 9:16：招牌文字放进引号，摊主的中文台词写成 `<d>[Chinese] …</d>`。「营业中」三个字和台词都对；画面底部自动加了中文字幕，结尾写了不要字幕也没去掉。提示词由 KovAPI 按官方指南的格式编写，成片由 KovAPI 生成。

提示词原文:

```text
integrated_multimodal_description: [Shot 1] Live-action, cinematic, a vertical medium shot of a small street-food stall in a narrow old alley at night. A red neon sign reading "营业中" glows above the stall and steam rises from a wok. The middle-aged cook with a warm, slightly hoarse voice (S1) tosses noodles in the wok as flames flare up, then looks at the camera and says: <d>[Chinese] 刚出锅的，趁热吃！</d> The camera pushes in with small amplitude at slow speed toward the wok. No subtitles or captions appear on screen.

overall_soundscape: Oil sizzles and the wok clangs against the burner while distant scooters and chatter fill the alley.

non_diegetic_music: N/A
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
integrated_multimodal_description（画面与台词）：[Shot 1] 实拍，电影感，竖屏中景：夜里，一条窄窄的老巷子里有个小吃摊。摊位上方亮着一块写着 "营业中" 的红色霓虹灯牌，炒锅里冒着热气。嗓音温暖、略带沙哑的中年摊主 (S1) 颠着锅里的面，火苗窜起，然后看向镜头说：<d>[Chinese] 刚出锅的，趁热吃！</d> 镜头以小幅度、慢速向炒锅推近。画面上不出现任何字幕或说明文字。

overall_soundscape（环境声）：热油滋滋作响，炒锅磕着灶台，远处的电动车声和人声充满巷子。

non_diegetic_music（配乐）：N/A（无）
```

### 首帧：雨夜车厢里的信

- 用 KovAPI 生成 · 首帧 · 6s · 1080P · 16:9 · image_role=first_frame
- 按现价 $0.216
- 成片: https://img.kovapi.com/i/mp-94892704d80349abfc4bbf4e.mp4
- 参考图 1: https://img.kovapi.com/i/mp-71b5ed84bb210183de898f1c.jpg

官方基础篇的首帧示例：第一行是对齐指令，成片从首帧开始，女孩抬头说出台词，再把信折好。提示词出自 MiniMax 官方《[视频提示词写作指南](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md)》，原句照搬；输入图由 KovAPI 用 Nano Banana Pro 按提示词里的描述生成。

提示词原文:

```text
For the target video, at 0.00 seconds into the target video, <Picture 1> (from [Shot 1]) is fully referenced.

integrated_multimodal_description: [Shot 1] Live-action, cinematic, the young woman shown in <Picture 1> remains beside the rain-covered train window, preserving her appearance, clothing, seat position, and the carriage layout. The camera trucks right with small amplitude at slow speed as she lifts her gaze from the folded letter toward the passing city lights. Her reflection moves across the glass while the quiet, breathy young woman (S1) says: <d>[English] I get off at the next station.</d> She folds the letter along its existing crease.

overall_soundscape: The train wheels produce a steady metallic rhythm beneath a low ventilation hum. Rain ticks against the window while paper rustles softly in her hands.

non_diegetic_music: Sustained cello notes at a slow tempo with widely spaced piano tones, gradually decreasing in volume.
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
对齐指令：目标视频第 0.00 秒完全参考 <Picture 1>（属于 [Shot 1]）。

integrated_multimodal_description（画面与台词）：[Shot 1] 实拍，电影感：<Picture 1> 里的年轻女子仍坐在挂满雨水的车窗边，保持她的样貌、衣着、座位和车厢布局。镜头以小幅度、慢速向右横移，她的目光从叠好的信上抬起，望向窗外掠过的城市灯光。她的倒影在玻璃上移动，这位声音轻柔、带着气声的年轻女子 (S1) 说：<d>[English] I get off at the next station.</d>（我下一站下车。）她沿着原来的折痕把信折好。

overall_soundscape（环境声）：车轮发出稳定的金属节奏声，底下是低低的通风嗡鸣。雨点敲着车窗，信纸在她手里轻轻沙沙作响。

non_diegetic_music（配乐）：慢速、持续的大提琴长音，配上间隔很大的钢琴音，音量逐渐减弱。
```

### 首尾帧：雨中撑开伞

- 用 KovAPI 生成 · 首尾帧 · 8s · 1080P · 16:9 · image_role=first_frame
- 按现价 $0.288
- 成片: https://img.kovapi.com/i/mp-227363d4eedb3bf23a3a199f.mp4
- 参考图 1: https://img.kovapi.com/i/mp-a560b1808c395d8022f926de.jpg
- 参考图 2: https://img.kovapi.com/i/mp-c32b3d1c8f0211a33cc0047c.jpg

官方基础篇的首尾帧示例：两张图分别对上第 0 秒和第 8 秒，正文只写中间的动作。成片从收伞的首帧开始，停在撑伞的尾帧上，雨声和开伞声都有。提示词出自 MiniMax 官方《[视频提示词写作指南](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md)》，原句照搬；输入图由 KovAPI 用 Nano Banana Pro 按提示词里的描述生成。

提示词原文:

```text
How the reference pictures align with the target video — Picture 1 (from Shot 1) aligns with the 0.00-second mark of the target video; Picture 2 (from Shot 1) aligns with the 8.00-second mark of the target video.

integrated_multimodal_description: [Shot 1] Live-action, cinematic, a rain-soaked cyclist begins in the position and framing established by Picture 1, holding a closed black umbrella beside a silver bicycle. The camera pulls out with small amplitude at slow speed as she releases the bicycle handle, raises the umbrella above her shoulder, and presses the runner upward until the canopy opens. Water rolls from the expanding fabric while she steps beneath it, rotates the handle into the final angle, and settles into the pose, spacing, and composition established by Picture 2 at the end of the shot.

overall_soundscape: Rain falls steadily on the pavement, followed by the metallic click of the umbrella runner and the soft snap of the canopy opening. Water drips from the bicycle frame as distant traffic passes.

non_diegetic_music: N/A
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
对齐指令：参考图与目标视频的对应关系是——Picture 1（属于 Shot 1）对齐目标视频的第 0.00 秒；Picture 2（属于 Shot 1）对齐目标视频的第 8.00 秒。

integrated_multimodal_description（画面）：[Shot 1] 实拍，电影感：一位被雨淋湿的骑车女子从 Picture 1 确定的位置和构图开始，拿着一把收起的黑伞站在银色自行车旁。镜头以小幅度、慢速向后拉，她松开车把，把伞举过肩头，向上推伞巢，直到伞面撑开。雨水从展开的伞面上滚落，她走到伞下，把伞柄转到最终的角度，在镜头结束时落到 Picture 2 确定的姿势、间距和构图上。

overall_soundscape（环境声）：雨稳定地落在路面上，接着是伞巢金属的咔嗒声和伞面撑开时轻轻的一声啪。水从自行车架上滴下，远处有车驶过。

non_diegetic_music（配乐）：N/A（无）
```

### 参考图：眼镜广告竖屏

- 用 KovAPI 生成 · 多图参考 · 8s · 1080P · 9:16 · image_role=reference
- 按现价 $0.288
- 成片: https://img.kovapi.com/i/mp-6a00ea489194c7c6e685fcf7.mp4
- 参考图 1: https://img.kovapi.com/i/mp-c542946f4a47ea07d3225571.jpg
- 参考图 2: https://img.kovapi.com/i/mp-dfa785dd4d3f560bb3eb9492.jpg
- 参考图 3: https://img.kovapi.com/i/mp-802c1b4d4b5ba8f59682ec61.jpg

三张参考图：两位模特、面部特写和眼镜设计。按参考篇的结构写清每张图的作用，模特戴上这副眼镜走台步，再切到戴眼镜的特写，最后多了一个眼镜的产品镜头。同样的创意用一句话简写时，成片只是把三张图逐张定格。三张参考图由 KovAPI 用 Nano Banana Pro 生成；创意照搬 MiniMax 官方[亮点页](https://platform.minimax.io/docs/guides/video-prompt)的眼镜广告，提示词由 KovAPI 按官方《[参考篇](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md)》的结构重写。

提示词原文:

```text
subject_definitions:
<Subject 1> is the two female fashion models in <Picture 1>, with slicked-back dark hair, one in a black asymmetric blazer with black-and-silver trousers, the other in a black leather crop top and a long silver satin skirt.
<Subject 2> is the facial detail of the same two models in <Picture 2>, defining their features and cool expressions.
<Subject 3> is the futuristic silver sunglasses in <Picture 3>, with wrap-around curves, a sharp cat-eye and goggle hybrid silhouette, mirrored lenses and thin streamlined temples.

summary:
[reference generation] A 9:16 high-fashion eyewear commercial on a minimal white cyc: <Subject 1>, with the faces of <Subject 2>, wear <Subject 3> and walk toward the camera with runway attitude, ending on a close-up of the sunglasses on one model's face.

retention_analysis:
<Subject 1> (appears in [Shot 1]): fully_preserved - the two models' outfits and slicked-back hair are retained.
<Subject 2> (appears in [Shot 1], [Shot 2]): fully_preserved - their facial features are retained.
<Subject 3> (appears in [Shot 1], [Shot 2]): fully_preserved - the wrap-around silver frame and mirrored lenses are retained.

detailed_description:
The target video is a clean, high-fashion commercial with soft, even studio light on a seamless white cyc.
[Shot 1] A vertical full-body shot: both models of <Subject 1>, each wearing a pair of <Subject 3>, walk side by side toward the camera with a confident runway stride and cool demeanor, their faces matching <Subject 2>. The camera pulls out with small amplitude at slow speed.
[Shot 2] At 00:04.000, the camera cuts to a close-up of the left model's face as she turns her head slightly; the mirrored lenses of <Subject 3> reflect the white studio, and the camera pushes in with small amplitude at slow speed toward the curved silver frame.

overall_soundscape:
Crisp heel clicks on the studio floor, then a soft whoosh as she turns her head.

non_diegetic_music:
A minimal electronic beat at a moderate tempo with deep synth bass, ending on a single sustained chord.
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
subject_definitions（素材定义）：
<Subject 1> 是 <Picture 1> 里的两位女模特，深色头发向后梳，一位穿黑色不对称西装外套和黑银拼色长裤，另一位穿黑色皮革短上衣和银色缎面长裙。
<Subject 2> 是 <Picture 2> 里同两位模特的面部细节，确定她们的五官和冷峻的表情。
<Subject 3> 是 <Picture 3> 里的未来感银色太阳镜：环绕式曲线，猫眼与护目镜结合的锐利轮廓，镜面镜片，细长流线的镜腿。

summary（概要）：
[参考生成] 一支 9:16 的高级时装眼镜广告，背景是极简的白色无缝影棚：<Subject 1> 以 <Subject 2> 的面容戴着 <Subject 3>，带着走秀的气场走向镜头，最后停在其中一位脸上太阳镜的特写。

retention_analysis（保留关系）：
<Subject 1>（出现在 [Shot 1]）：完全保留——两位模特的服装和后梳的发型保留。
<Subject 2>（出现在 [Shot 1]、[Shot 2]）：完全保留——她们的五官保留。
<Subject 3>（出现在 [Shot 1]、[Shot 2]）：完全保留——环绕式银色镜框和镜面镜片保留。

detailed_description（分镜描述）：
目标视频是一支干净的高级时装广告，白色无缝影棚，柔和均匀的棚灯。
[Shot 1] 竖屏全身镜头：<Subject 1> 的两位模特各戴一副 <Subject 3>，以自信的台步和冷静的神态并肩走向镜头，脸与 <Subject 2> 一致。镜头以小幅度、慢速向后拉。
[Shot 2] 在 00:04.000，镜头切到左边那位模特的面部特写，她微微转头；<Subject 3> 的镜面镜片映出白色影棚，镜头以小幅度、慢速推向弧形的银色镜框。

overall_soundscape（环境声）：
鞋跟在影棚地面上清脆的声音，接着是她转头时轻轻的一声呼啸。

non_diegetic_music（配乐）：
中速的极简电子节拍，配深沉的合成器低音，最后停在一个持续的和弦上。
```

### 参考视频：照着运镜拍跑鞋

- 用 KovAPI 生成 · 参考视频 · 6s · 768P · 16:9 · image_role=reference
- 按现价 $0.325
- 成片: https://img.kovapi.com/i/mp-aa7f83de1a85c8445731122b.mp4
- 参考图 1: https://img.kovapi.com/i/mp-cc795e889918bc095cfac8c6.jpg
- 参考视频 (7s): https://img.kovapi.com/i/mp-dd0414d99599d8386d11fbfd.mp4

参考视频是一段绕着雕像慢慢转的镜头，参考图是一只跑鞋。成片把跑鞋放上了同样的石台和广场，镜头只转了一小段，结尾还多切了一个镜头：运镜参考能借到场景和节奏，幅度不一定一样。参考视频同样由 KovAPI 用 H3 生成，参考图由 KovAPI 用 Nano Banana Pro 生成，提示词由 KovAPI 编写。

提示词原文:

```text
The running shoe from image 1 stands on a stone pedestal in the middle of an empty plaza at golden hour. Follow the camera movement and pacing of video 1: a slow arc shot around the subject from left to right, keeping it centered. Do not show the statue from video 1. Sound: soft wind and distant pigeons. No music.
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
图 1 里的跑鞋立在黄昏时空荡广场中央的石台上。跟随视频 1 的运镜和节奏：从左到右慢慢环绕主体，让它保持在画面中央。不要出现视频 1 里的雕像。声音：轻柔的风声和远处的鸽子。不要配乐。
```

### 参考视频：狐狸跳同一段舞

- 用 KovAPI 生成 · 参考视频 · 6s · 768P · 16:9 · image_role=reference
- 按现价 $0.325
- 成片: https://img.kovapi.com/i/mp-e2308084597964acbd152bce.mp4
- 参考图 1: https://img.kovapi.com/i/mp-f75baad27af554d861a38176.jpg
- 参考视频 (7s): https://img.kovapi.com/i/mp-f34bfc40277ff5ab18021caa.mp4

参考视频是一段真人舞蹈，参考图是一只卡通狐狸。成片里的狐狸跟着做了举手、摆动和转圈，动作顺序和参考视频一致。参考视频同样由 KovAPI 用 H3 生成，参考图由 KovAPI 用 Nano Banana Pro 生成，提示词由 KovAPI 编写。

提示词原文:

```text
The cartoon red fox in the yellow hoodie from image 1 performs the same dance routine as the dancer in video 1, with the same arm raises, hip sways, spin and ending pose, in a colorful cartoon bedroom. 3D animated style, static full-body shot. Sound: upbeat pop drums and bass, the fox's sneakers tapping on the floor.
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
图 1 里穿黄色卫衣的卡通红狐狸，跳视频 1 里舞者的同一段舞：同样的举手、摆胯、转圈和结束姿势，场景是色彩鲜艳的卡通卧室。3D 动画风格，固定的全身镜头。声音：欢快的流行鼓点和贝斯，狐狸的运动鞋踩在地板上的声音。
```

### Lite：跑鞋转台镜头

- 用 KovAPI 生成 · 多图参考 · 5s · 768P · 16:9
- 按现价 $0.0625
- 成片: https://img.kovapi.com/i/mp-5a3d34dd41ce101dcf3825c9.mp4
- 参考图 1: https://img.kovapi.com/i/mp-cc795e889918bc095cfac8c6.jpg

用 [MiniMax H3 Lite](https://kovapi.com/zh/model/minimax-h3-lite) 生成：一张跑鞋参考图，768P 5 秒。费用按 Lite 的价格算，只能在 Lite 页面套用到在线测试。提示词由 KovAPI 按官方指南的格式编写，输入图由 KovAPI 用 Nano Banana Pro 生成。

提示词原文:

```text
The running shoe from the reference image rotates slowly on a glossy black turntable while streaks of neon light sweep across it, close studio product shot. Sound: a low electronic hum.
```

阅读译文 (译文只供阅读；复制和套用都用原文):

```text
参考图里的跑鞋在光亮的黑色转台上慢慢转动，一道道霓虹光扫过鞋面，近距离的棚拍产品镜头。声音：低沉的电子嗡鸣。
```

## MiniMax H3 提示词：照官方结构写

以 MiniMax 官方《视频提示词写作指南》为准（[基础篇](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md)、[参考篇](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md)）。官方的说法是 H3 比多数模型更看重提示词结构：按镜头写画面，台词放进标签，环境声和配乐各写一段。下面的写法出自官方指南，例句是本页案例实际提交的提示词；标「实测」的是我们自己测出来的。

- **分三段写**: `integrated_multimodal_description` 写画面、动作、镜头和台词；`overall_soundscape` 用 1–4 句写环境声和动作声；`non_diegetic_music` 写只有观众听得到的配乐，不要配乐就写 `N/A`。实测：同一个面包店场景用一句话写，台词和切镜也有，但没有配乐、音效对不上；按三段写，木吉他、门铃和切面包声都照提示词出来了。 — 面包店原文开头：“integrated_multimodal_description: [Shot 1] Live-action, cinematic, …”
- **按镜头分段，写清切换时间**: 第一个镜头 `[Shot 1]` 不写时间，后面的镜头写成 `[Shot 2] At 00:05.000, the camera cuts to…`。本页几条多镜头案例，切换都落在写的时间点附近。 — 面包店原文：“[Shot 2] At 00:05.000, the camera cuts to a close-up of steam rising from the sliced bread”
- **运镜写成「类型 + 幅度 + 速度」**: push in、pan、truck、arc shot、tracking shot 这类运镜，加上 with small amplitude、at slow speed，写成句子里的动作，不要在句末堆标签。 — 面包店原文：“The camera pushes in with small amplitude at slow speed as the middle-aged baker…”
- **台词写进对白标签**: 说话人用 (S1)、(S2) 编号，先交代年龄、音色，再把台词写成 `<d>[English] …</d>`，原文照写、不要翻译。中文台词写 `[Chinese]`。 — 火车原文：`the quiet, breathy young woman (S1) says: <d>[English] I get off at the next station.</d>`
- **画面里的字放进引号**: 招牌、标语要出现的字放进英文双引号，原样照写。实测「营业中」三个字写对了；没写进引号的背景招牌，字多半是乱的。 — 霓虹小摊：“A red neon sign reading "营业中" glows above the stall”
- **中文台词会带字幕**: 实测中文台词的镜头两次都在画面底部加了中文字幕，提示词里写了不要字幕也没去掉；英文台词的几条都没有字幕。要干净的画面，台词用英文，或者后期处理。 — 霓虹小摊结尾这一句没起作用：“No subtitles or captions appear on screen.”
- **首尾帧写清对齐和路径**: 首帧任务第一行写对齐指令；首尾帧写明第二张图对上第几秒，正文写中间怎么动，不要把两张静态图再描述一遍。 — 撑伞原文：“Picture 2 (from Shot 1) aligns with the 8.00-second mark of the target video”
- **参考模式给每份素材起名**: 用 `<Subject 1>`、`<Picture 1>` 给每份素材起名，写清它在成片里的作用。实测：照官方亮点页的一句话写法（「Image 1: …, Image 2: …」），成片把三张参考图逐张拍成了几乎不动的镜头；按参考篇的结构重写以后，模特戴上眼镜走起了台步。 — 眼镜广告：`<Subject 3> is the futuristic silver sunglasses in <Picture 3>…`

| 部分 | 作用 | 示例 |
| --- | --- | --- |
| 画面段 | 以 `integrated_multimodal_description:` 开头，下面按镜头写。 | 原文：“integrated_multimodal_description: [Shot 1] …” |
| 风格与景别 | 第一个镜头先写风格和景别。 | 原文：“Live-action, cinematic, a medium-wide shot frames a baker opening the shutters…” |
| 运镜与动作 | 运镜写类型、幅度和速度，和动作写在同一句。 | 原文：“The camera pushes in with small amplitude at slow speed as the middle-aged baker… places a fresh loaf on the wooden counter” |
| 台词 | 说话人编号、音色和台词标签。 | 原文：`with a calm, slightly raspy voice (S1) … says: <d>[English] First batch of the morning.</d>` |
| 切镜 | 新镜头写切换时间和新画面。 | 原文：“[Shot 2] At 00:05.000, the camera cuts to a close-up of steam rising from the sliced bread” |
| 两段声音 | 环境声一段，配乐一段。 | 原文：“overall_soundscape: Wooden shutters scrape open… non_diegetic_music: A soft acoustic-guitar pattern…” |

```text
integrated_multimodal_description: [Shot 1] [风格，例如 Live-action, cinematic], [景别] frames [主体和场景]. The camera [运镜] with [small / large] amplitude at [slow / fast] speed as [动作]. The [说话人的年龄和音色] (S1) says: <d>[English] [台词]</d> [Shot 2] At 00:0X.000, the camera cuts to [下一个画面].

overall_soundscape: [环境声和动作声，1–4 句]

non_diegetic_music: [配乐的乐器、速度和强弱变化；不要配乐写 N/A]
```

## 如何在 KovAPI 上用 MiniMax H3 Lite 生成视频

1. **注册并创建 API Key** 登录 KovAPI，在控制台创建 Key；同一把 Key 可以调用站内所有模型。
2. **在页面上方试提示词** 选好时长、分辨率和画幅，可以上传参考图，提交前就能看到实时报价。
3. **提交异步生成任务** 用 `minimax-h3-lite` 提交到 `POST /v1/videos/generations`，收到 HTTP 202 后保存任务号；完整请求示例见文档。
4. **查询结果或接收 Webhook** 按任务号轮询，或提交时设置 `callback_url` 接收结果。成功后从 `data[0].url` 下载 MP4；成片保留 7 天，请及时保存。

### 最小请求示例

```bash
curl https://kovapi.com/v1/videos/generations \
  -H "Authorization: Bearer $KOVAPI_KEY" -H "Content-Type: application/json" \
  -d '{"model": "minimax-h3-lite", "prompt": "...", "duration": 4, "resolution": "1080P", "size": "16:9"}'
# -> HTTP 202 {"id": "..."}; poll:
curl https://kovapi.com/v1/videos/jobs/<id> -H "Authorization: Bearer $KOVAPI_KEY"
```

## MiniMax 视频模型的演进

- 2025-02-11 · T2V-01-Director: **T2V-01-Director · 运镜控制** 在提示词里写运镜指令，模型按指令推拉摇移；H3 的提示词指南沿用了这一套运镜写法。
- 2025-06-18 · MiniMax Hailuo 02: **Hailuo 02 · 1080P** 第二代视频模型，支持 1080P，单条最长 10 秒。
- 2025-10-28 · MiniMax Hailuo 2.3: **Hailuo 2.3 / 2.3 Fast** 肢体动作、面部表情、物理真实感和提示词遵循都有提升；Fast 版只做图生视频。
- 2026-07-31 · MiniMax H3: **MiniMax H3 · 第三代** 文字、图片、视频、音频放在一起理解，画面和立体声一次生成；首帧、首尾帧、参考图、参考视频都在同一个模型里。KovAPI 提供 480P / 768P / 1080P 三档。

## MiniMax H3 与其他视频模型怎么选

| 型号 | 时长（秒） | 分辨率 | 参考 图 / 视频 / 音频 | 价格 | 适合 |
| --- | --- | --- | --- | --- | --- |
| MiniMax H3 Lite (`minimax-h3-lite`) | 4–15 | 480P / 768P | 5/0/0 | $0.005/秒 | 批量打样、试提示词：同一个 H3，推理步数更少，更快、更便宜，画质略低；只有文生和参考图。 |
| MiniMax H3 (`minimax-h3`) | 4–15 | 480P / 768P / 1080P | 9/3/3 | $0.015/秒 | 要 1080P 带声短片、首尾帧，或者参考图配参考视频一起用；480P 打样也便宜。 |
| Wan 3.0 (`wan3.0-video`) | 4–30 | 480P / 720P / 1080P | 10/5/5 | $0.04/秒 | 单条要超过 15 秒（最长 30 秒），或者要用文档、网页生成视频。 |
| Seedance 2.5 (`seedance-2.5`) | 4–30 | 480P / 720P / 1080P | 30/10/10 | $0.10/秒 | 要放进大量参考素材，或者单条最长 30 秒的叙事短片。 |
| Seedance 2.0 Fast (`seedance-2.0-fast`) | 5–15 | 480P / 720P | 9/3/3 | $0.052/秒 | 要快、预算有限的 Seedance 短片。 |
| Gemini Omni 1.2 Flash (`gemini-omni-1.2-flash`) | 3–15 | 720P / 1080P / 4K | 3/0/0 | $0.035/秒 | 要用一句话编辑已有视频，或者要 4K、画面文字写得准。 |
| Veo 3.1 (`veo-3.1`) | 8 | 720P / 1080P | 3/0/0 | $0.20/条 | 固定 8 秒、按条计费的短片。 |
| Grok Imagine Video 1.5 (`grok-imagine-video-1.5`) | 4–15 | 480P / 720P / 1080P | 7/0/0 | $0.025/秒 | 按条计费的 480P / 720P 短片，参考图可以给到 7 张。 |

已有其他模型的样片时，用同一组素材和验收标准对比画面、动作、声音、出片耗时和实际费用，再决定换不换。H3 和 Lite 之间怎么选，看上面的同题对比。

## 组合规则与注意事项

- Lite 不做首帧和首尾帧：图片一律当参考图，写 `image_role: first_frame` 会直接报错，不扣费。要让成片从某张图开始，用标准版。
- Lite 不收参考视频和参考音频，带了会报错、不扣费；要用这两种素材，请用标准版。
- 只有 480P 和 768P 两档，`1080P` 会被拒，`720P` 按 768P 处理。每条成片都带声音，不要配乐就在提示词里写 `non_diegetic_music: N/A`。

## 为什么在 KovAPI 使用 MiniMax H3 Lite

- **打样成本低**: Lite 的 480P 每秒 $0.005、768P 每秒 $0.0125。同一段提示词先在 Lite 上批量试构图和动作，选中的再切到标准版出 1080P。在线测试提交前就显示这一单的价格。
- **失败不扣费，自动重试**: 生成失败，预扣的费用全额退回；上游繁忙或出错时系统自动重试，不用自己写重试逻辑。
- **不限并发**: 每个账号不设并发上限，批量任务直接提交；高峰时自动排队，接口返回 `queue_position` 和 `eta_seconds`，完成后可推送 Webhook。
- **视频模型一套接口**: 提交、查询和 Webhook 的写法对站内所有视频模型都一样，改 `model` 就能把同一段提示词交给标准版或 Wan、Seedance 等模型对比。
- **注册和付款都简单**: 邮箱或 Google、GitHub 注册，微信、银行卡、PayPal、USDT 都能充值，按量扣费、没有月费；同一把 Key 还能调用站内的对话和生图模型。

## MiniMax H3 API 常见问题

### MiniMax H3 是什么？

MiniMax 2026 年 7 月发布的视频模型，官方称它是继 Hailuo 01、Hailuo 02 之后的第三代。它能同时理解文字、图片、视频和音频，成片自带声音。在 KovAPI 用 `minimax-h3` 调用，支持文生视频、首帧、首尾帧、参考图和参考视频。

### 能生成多长的视频？

4–15 秒，按整秒任选，不传 `duration` 时 5 秒。成片会比请求的秒数多零点几秒，例如 5 秒的任务约 5.2 秒，按请求的秒数计费。

### 三档分辨率怎么选？实际多大？

480P 适合打样和批量，768P 兼顾清晰度和价格，1080P 画面最细，不传 `resolution` 时为 1080P。16:9 时 480P 是 864×480，768P 约 1344×768，1080P 约 1920×1080；不同任务会差几十个像素。

### 传 720P 可以吗？

可以，按 768P 生成、按 768P 计费。其他取值（例如 2K、4K）提交时直接报错，不扣费。

### 首帧和参考图怎么切换？

不写 `image_role` 时，1 张图是首帧，2 张是首尾帧。写 `image_role: reference` 就是参考图，最多 9 张，图里的人物、商品和场景会出现在画面里，不当作某一帧。要带参考视频或参考音频，必须用参考模式。

### 参考视频能做什么？怎么计费？

可以让成片参考它的动作、运镜或节奏：本页的狐狸就照着一段真人舞蹈跳了同样的动作。参考视频的秒数按所选档位的单价计费，和成片秒数加在一起算，例如 768P、成片 6 秒、参考视频 7 秒，按 13 秒计。最多 3 段，每段 2–15 秒、合计不超过 15 秒。

### 参考音频有用吗？收费吗？

不收费，最多 3 段，要和参考图或参考视频一起传。官方指南里它可以作音色或配乐的参考；我们实测让角色照参考音频的音色说新台词，两次声音都没有明显变化，所以不建议靠它定音色。

### 参考素材有什么格式和大小要求？

图片：JPG / PNG / WEBP（不收 GIF），单张不超过 16MB，宽和高都在 256–5760 像素之间、宽高比 0.4–2.5；标准版参考模式最多 9 张，Lite 最多 5 张。参考视频（仅标准版）：MP4 / MOV（H.264 / H.265 编码，音轨 AAC / MP3），最多 3 段，每段 2–15 秒、合计不超过 15 秒，单段不超过 50MB。参考音频（仅标准版）：WAV / MP3，最多 3 段，每段 2–15 秒、合计不超过 15 秒，单段不超过 15MB。不符合的提交时直接拒绝（编码不对的会在生成时失败），都不扣费。

### 能关掉声音吗？

不能，每条成片都带音轨，`audio: false` 会被拒。不要配乐就写 `non_diegetic_music: N/A`；要完全无声的素材，下载后去掉音轨。

### 台词能用中文吗？

可以。台词写成 `<d>[Chinese] …</d>`，我们实测那条中文台词一字不差，但画面底部会自动加上中文字幕，写了不要字幕也没去掉。MiniMax 官方说对白稳定支持中、英、日、韩、西、俄等 11 种语言。提示词正文按官方指南用英文写更稳。

### 能用真人照片吗？

可以。我们用两张普通人的照片测试，作首帧、作参考图各 2 次，都正常出片。请确认你有权使用照片里的人物肖像。

### 出片要多久？

2026 年 11 月 12 日我们的 30 多条测试里，大多数 2–6 分钟出片，个别超过 15 分钟；分辨率越高、参考素材越多越久，高峰时更久。这是异步任务，提交后用任务号轮询，或设置 `callback_url` 等通知。

### 生成失败会扣钱吗？

生成失败，未计费，可原样重新提交。提交时的预扣会全额退回，同一任务的自动重试只结算一次。

### 成片能保存多久？

成片和上传的素材保留 7 天，到期自动删除，请及时下载保存。

### H3 和 H3 Lite 怎么选？

[MiniMax H3 Lite](https://kovapi.com/zh/model/minimax-h3-lite) 是同一个 H3，推理步数更少，更快、更便宜，画质略低；只有 480P / 768P，只做文生和参考图，不收参考音视频。先用 Lite 试提示词和构图，定稿再用 H3 出 1080P。上面的同题对比里可以直接看两者的差别。

### H3 和 Wan 3.0、Seedance 2.5 怎么选？

单条要超过 15 秒，用 [Wan 3.0](https://kovapi.com/zh/model/wan3.0-video) 或 [Seedance 2.5](https://kovapi.com/zh/model/seedance-2.5)（最长 30 秒）；要首尾帧、低价的 480P 打样，H3 更合适。最好用同一段提示词在几个模型上各跑一条再比。

### 本页的案例是怎么来的？

都是 KovAPI 通过自己的 API 按页面上的参数生成的，每条都标了生成参数和按现价算的费用。提示词大多照搬 MiniMax 官方指南的原句，输入图由 KovAPI 用自己的图片模型生成。

## 给 AI 的补充说明

- 型号 id 为 `minimax-h3`，使用 `POST /v1/videos/generations` 提交，返回 HTTP 202 和任务号 `id`；用 `GET /v1/videos/jobs/` 加任务号查询结果。
- `resolution` 可选 480P / 768P / 1080P，默认 1080P；`720P` 按 768P 处理。`size` 可选 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9。`duration` 为 4–15 的整数，默认 5。
- 图片放 `images`：不写 `image_role` 时 1 张是首帧、2 张是首尾帧；`image_role: reference` 时最多 9 张参考图，3 张以上必须写 reference。
- 参考视频字段 `video_references`（或 `video_reference`），最多 3 段、每段 2–15 秒、合计 ≤15 秒、MP4 / MOV、按秒计费；参考音频字段 `audio_references`（或 `audio_reference`），最多 3 段、WAV / MP3、每段 2–15 秒、合计 ≤15 秒、只收 URL、不收费、必须和参考图或参考视频一起传。都只能在参考模式下用。
- `reference_audios`、`reference_videos`、`start_frame`、`end_frame` 以及首帧模式带音视频，提交时返回 HTTP 400，不扣费。
- 计费：所选档位的每秒单价 ×（成片秒数 + 参考视频秒数）；480P $0.015/秒、768P $0.025/秒、1080P $0.036/秒。
- 成片固定带音轨，`audio: false` 会被拒；提示词最多 5,000 个字符，官方推荐的结构化写法见本页「提示词」一节。实测：参考音频没有明显影响音色；中文台词会自动带字幕。

## 延伸阅读

- [MiniMax H3 API 调用文档](https://docs.kovapi.com/zh/minimax-h3): 请求字段、异步任务、返回结果和完整代码示例。
- [MiniMax H3 Lite](https://kovapi.com/zh/model/minimax-h3-lite): 同一个 H3，更快、更便宜，适合批量打样。
- [MiniMax H3 价格对比](https://kovapi.com/zh/compare/minimax-h3): 官方和各平台每档的每秒价，逐格附出处。
- [异步任务指南](https://docs.kovapi.com/zh/guide/async-jobs): 任务状态、排队字段与结果查询。
- [Webhook 接入指南](https://docs.kovapi.com/zh/webhooks): 接收任务结果，并按文档验证通知签名。
