New: 在您的 coding agent 中使用 KIE 模型 →
minimax-h3 / text-to-video
Commercial usePart of the Hailuo API family — compare all Hailuo models →

MiniMax H3（即海螺 03）融合了文本、图像、视频和音频，支持 2K 视频生成、多模态参考、原生立体声、动作迁移及精准编辑。

Model Type:
Pricing: Video generation & video input — 768P: 8 credits/s ($0.04/s); 2K: 13 credits/s ($0.065/s). Video input is charged at the corresponding resolution rate. Additional image input: 4 credits/image ($0.02/image) for both 768P and 2K. Total Cost = Unit Price × (Generated Video Duration + Input Video Duration) + Additional Image Cost - Input images: The first 5 images are free; additional images are charged separately. - Input audio: Free. Pricing is 50% of the official price. High-tier top-ups reduce the effective cost to approximately 90% of the listed price.
Input

Video description prompt.

0/7000

Video duration in seconds. Available values: 4-15.

The ratio of output video.

Video resolution.

Output
output typevideo
Examples

Explore different use cases and parameter configurations

README

Complete guide to using minimax-h3/text-to-video

MiniMax H3 API：集视频生成与编辑于一体

在 Kie.ai 上调用 MiniMax H3 API，将提示词与多模态参考转化为高品质 2K 视频，具备原生立体声、连贯的动作表现及精准的创意控制。

MiniMax H3 如何拓展多模态视频创作边界

MiniMax H3（又称 Hailuo 03）是一款开放的通用多模态视频生成系统，能够在统一的创作语境下理解文本、图像、视频和音频。它支持生成时长 5 至 15 秒、最高 2K 分辨率且自带原生立体声的视频，并能精准遵循关于角色、动作、运镜、画面结构、视觉风格、对话、音乐、音效、可读文本及品牌元素的详细指令。统一的多模态理解能力还实现了基于参考素材的创作、音视频迁移及精准编辑，为商业级内容生产提供支持。目前，MiniMax H3 API 已在 Kie.ai 上线，并提供三种生成方式：文生视频、图生视频以及参考素材生视频。开发者可根据现有素材灵活选择合适的生成模式——无论是从文本提示词开始、让单张图像或指定的首尾帧动起来，还是组合多种图像、视频及音频参考素材。欢迎前往 Kie.ai 查看最新的 MiniMax H3 API 接口文档，获取当前请求参数、支持的输入格式、生成设置及接入说明。

使用 MiniMax H3 API 的文生视频功能，构建原创视听场景

文生视频功能无需上传媒体素材，直接通过文本提示词即可生成完整的视听片段。开发者只需一次请求，就能定义环境、角色、动作、运镜、镜头推进、视觉风格、对话、音乐及环境音。MiniMax H3 API 非常适合完全基于文本指令来创作广告创意、电影片段、动画短片、动态图形、社交内容及产品视觉表现。

使用海螺 03 API 实现单图或首尾帧动画生成

图生视频支持上传单张图片或首尾两帧图片。单张图片可作为画面的初始视觉状态，生成自然的角色动作、环境动态及镜头动画；提供首尾两帧，则能让开发者更精准地控制视频的起始、过渡与结尾。Hailuo 03 API 非常适用于动态海报、产品展示、UI 演示、角色表演、主视觉动画以及结构化的视觉过渡效果。

通过 Hailuo-03 API 的“参考生视频”功能实现多模态素材融合

“参考生视频（Reference to Video）”支持在单次生成请求中，将文本指令与参考图像、视频片段及音频文件自由组合。开发者可将各项独立素材分别用于设定角色身份、产品外观、动作、镜头语言、剪辑节奏、视觉风格、人声或音效设计。此外，Hailuo-03 API 还支持主体替换、动作迁移、背景修改、重新打光、台词更改、声音匹配、服装更换、产品替换及局部编辑，同时能完美保留原素材中不受影响的部分。

MiniMax H3 API 在多模态视频生成领域的独特优势

MiniMax H3 API 中的统一多模态语境

MiniMax H3 API 支持在同一上下文中解析文本、图像、视频片段和音频。每种输入均可发挥不同作用，如定义角色身份、引导动作、设定镜头语言、匹配视觉风格，或提供语音和声音参考。这种统一的理解能力有助于各创意元素在最终视频中保持连贯。

Hailuo 03 API：原生 2K 视频与立体声音频

Hailuo 03 API 最高可生成 2K 视频及原生立体声，无需通过独立的后期流程添加音频。视觉动作、对话、音乐、环境音及音效均可在同一提示词中进行引导控制，从而带来更出色的视听连贯性，使画面与声音的同步更加自然。

Hailuo-03 API：灵活的多重参考控制

Hailuo-03 API 支持在单次生成中组合多张图像、视频片段与音频文件。角色身份可源自图像，动作与镜头表现可源自视频，语音或声音特征可源自音频参考。自然语言指令能够清晰指明每个素材应如何影响生成结果，从而减少不同参考素材之间的冲突。

Hailuo 3.0 API：强大的指令遵循与文字渲染能力

Hailuo 3.0 API 精准遵循镜头顺序、时间节点、转场、运镜、角色行为、声音设计及固定元素等详细指令。不仅能渲染更清晰的文本、标题、UI 界面、标识与品牌细节，还能更稳定地响应正向指令与明确的限制条件。

通过 Hailuo AI API 实现精准视频编辑

Hailuo AI API 可对现有视频素材进行定向修改，无需重绘整个场景。在保留原有构图、运动轨迹、时间节点与环境细节的前提下，能够替换或调整人物、物体、服装、背景、光影、对话、声音及视觉效果。

MiniMax H3 vs Seedance 2.0：创意优势的分野

在相似的创作方向下，MiniMax H3 与 Seedance 2.0 通常会呈现出明显不同的视觉方案。以下四组对比重点展示了它们在产品叙事、动态设计、电影级视觉呈现以及界面动画方面的不同处理方式。

MiniMax H3 构建更完整的产品叙事

MiniMax H3 通过丰富的运镜角度、功能特写、连贯的充电动作、清晰可读的规格参数，以及全程一致的产品材质，构建出结构更严谨的商业广告。相比之下，Seedance 2.0 虽能生成运镜流畅、光影纯净的精美演播室效果，但镜头推进较为简单，对具体功能的刻画较弱。MiniMax H3 在产品设计、功能展示、排版布局及最终的品牌露出之间，展现出了更强的连贯性。

Hailuo 03 与 Seedance 2.0 走上了截然不同的动态设计路线

Hailuo 03 融合网格、流体、立体元素与醒目排版，配合快速切换的构图，打造出更紧凑的动态视觉序列。相比之下，Seedance 2.0 更偏爱纯粹的几何变换与克制的版式设计，向片尾字幕的过渡也更为简洁。整体而言，Hailuo 03 呈现出更丰富的视觉层次与剪辑张力，而 Seedance 2.0 则保持了极简且统一的图形语言。

Hailuo-03 更倾向于商业写实，而非未来感风格

Hailuo-03 运用写实材质、精准特写与技术信息浮层，在多变视角下始终以统一的黑白红视觉体系呈现赛车。而 Seedance 2.0 则更侧重于发光的蓝图特效、全息组件以及更强烈的速度感。Hailuo-03 让车辆特征更清晰、更具商业落地价值，而 Seedance 2.0 则更加强调风格化的科技视觉奇观。

Hailuo 3.0 保留了界面设计，而 Seedance 2.0 则进行了全面重构

Hailuo 3.0 将控制器与原网页无缝融合，在镜头穿梭于页面布局时，完整保留了原有的排版、碳纤维纹理、界面控件以及高对比度的视觉层级。相比之下，Seedance 2.0 将素材转化为独立的产品展示，加入了蓝色动态背景、极具冲击力的特写镜头以及全新的宣传文案。总体而言，Hailuo 3.0 更忠于原始界面的结构，而 Seedance 2.0 的处理方式更加自由，视觉呈现更接近传统的产品广告片。

如何将 MiniMax H3 API 从 Playground 推向生产环境

借助 Kie.ai，您可以轻松完成从早期测试到打造完整视频生成体验的过渡。建议先测试创意参数，定义稳定可靠的输入结构，再将验证后的工作流直接集成到您的产品中。

  • 1. 注册并妥善保管您的 MiniMax H3 API Key

    创建 Kie.ai 账号或登录您的现有账号，然后在控制台中生成 API Key。在开始集成前，请妥善保管该密钥，并确保其与任何客户端环境隔离。

  • 2. 在 MiniMax H3 API Playground 中验证创意配置

    在正式编写代码前，您可以直接在 Playground 中探索文本生成视频、图像生成视频以及参考素材生成视频等功能。建议多测试提示词、单张图像、首尾帧及多模态参考输入，以找出能够精准还原预期动态效果、画面构图、音频及视觉一致性的最佳参数配置。

  • 3. 配置 MiniMax H3 API 输入参数

    明确您的产品支持的提示词、媒体格式、生成模式及可调参数。清晰的输入结构不仅能正确处理每一次创作请求，还能有效减少无效提交与生成结果的不一致性。

  • 4. 将 MiniMax H3 API 集成到您的产品中

    将验证后的生成流程无缝接入您的网站、应用或内部创作平台。根据产品体验需求，灵活配置身份验证、输入处理、生成控制、进度管理及输出展示。

  • 5. 部署并扩展 MiniMax H3 API 工作流

    将集成方案发布至生产环境。随着使用量的增长，持续优化提示词模板、校验规则、请求管理与并发处理能力。请在 Kie.ai 查看最新的 MiniMax H3 API 文档，获取最新参数、支持的输入格式及接入指南。

MiniMax H3 API 在现代视频创作中的应用场景

基于 MiniMax H3 API 的广告与产品营销方案

Product films can combine close-up details, feature demonstrations, branded typography, camera transitions, and synchronized sound within one continuous sequence. MiniMax H3 API also helps preserve product materials, proportions, packaging, and visual identity across changing shots, making the final result feel more cohesive and commercially polished.

通过 Hailuo 03 API 打造电影级片头与动态设计

Hailuo 03 API can build opening sequences, animated posters, music visuals, and editorial motion graphics from detailed creative direction. Typography, geometric layouts, layered effects, transitions, camera movement, music, and sound cues can develop together over time instead of appearing as disconnected visual elements.

使用 Hailuo-03 API 创作角色驱动的剧情故事

Short dramas, character promos, motion comics, and stylized narratives benefit from consistent faces, clothing, props, voices, and performance details across the scene. Hailuo-03 API can also draw motion, camera language, atmosphere, or dialogue delivery from separate references while keeping the central character recognizable.

面向 UI、游戏及数字体验概念的 Hailuo 3.0 API

Interface animations can preserve webpage structure, menus, typography, controls, and product imagery while introducing scrolling, hover states, transitions, loading sequences, and environmental reveals. Hailuo 3.0 API also supports game menus, equipment customization, cinematic gameplay concepts, and other digital experiences that combine interface logic with animated storytelling.

为 MiniMax H3 API 编写更高效的提示词

优质的生成效果不仅仅依赖于对画面内容的简单描述。清晰的提示词需要系统规划视觉意图、角色参考、时间节点、运镜方向、声音效果及保留要求，确保生成的每一个环节都能精准贯彻您的创作构思。

  • 01

    在 MiniMax H3 API 中明确每个参考素材的作用

    当同时使用多个图片、视频或音频素材时，请明确说明每个素材的控制目标。您可以通过不同的参考素材分别设定角色身份、产品外观、动作、镜头语言、剪辑节奏、视觉风格、人声或音效，从而有效减少不同输入指令间的冲突。

  • 02

    借助 Hailuo 03 API 编排长序列

    将多镜头的构思拆解为清晰的递进关系，确保动作、转场和视觉变化按预期的顺序发生。结构化的序列有助于 Hailuo 03 API 在整个时长内保持良好的节奏，避免将所有创意堆砌在开场几秒或生成毫不相干的零散画面。

  • 03

    在 Hailuo-03 API 中统筹视听元素

    请将对白、音乐、环境音及音效与画面构图、动作设计视为统一的创作整体。在描述视觉序列的同时，一并说明声音提示、情感基调及随时间的变化，Hailuo-03 API 便能更高效地实现音频与视觉动作的协同。

  • 04

    借助 Hailuo 3.0 API 保持身份与设计细节

    请详细列出必须保持一致的面部特征、服饰、道具、材质、色彩、排版或产品细节。明确的保留指令能为 Hailuo 3.0 API 提供更强的锚点，确保在不断变化的镜头与视角中，主体和视觉元素始终保持高度可辨识度。

  • 05

    为 MiniMax H3 API 设定镜头语言

    请详细描述画面的构图、镜头语言、运镜方式、焦点切换、曝光设定及整体影像基调。明确的摄影指令能帮助 MiniMax H3 API 呈现更具深度的视觉叙事，避免画面出现套路化的运镜或重复性构图。

  • 06

    在 Hailuo 03 API 提示词中添加明确的限制条件

    请明确指出需要避免的元素、转场、风格或视觉瑕疵。负面限制条件能够引导 Hailuo 03 API 始终贴合您的预期创作方向，特别是在处理文字排版、角色一致性、界面布局、写实素材或高度风格化场景时，效果尤为显著。

  • 07

    使用 Hailuo AI API，保持编辑指令精准

    在进行视频编辑时，请明确需要修改的细节以及必须保留的原画面。建议将替换、移除、重新打光、对话修改及背景调整等指令分开表述，这样不仅便于 Hailuo AI API 进行局部精准修改，还能完美保留原素材的时间线、构图、运镜以及未受影响的场景细节。

    • 为什么 Kie.ai 是接入 MiniMax H3 API 的最佳选择？

    极具竞争力的 MiniMax H3 API 定价，助力规模化创作

    灵活的按量计费模式，帮您轻松控制测试、日常内容生产及大规模生成阶段的成本。Kie.ai 上的 MiniMax H3 API 定价支持业务平滑扩展，无需投入专用硬件或复杂的基础设施。

    详尽的 Hailuo 03 API 文档，助力高效接入

    API 文档详细涵盖鉴权机制、生成模式、支持的输入格式、请求配置及接入指南。Hailuo 03 API 资源可有效减少繁琐的初始配置工作，让接入过程的每个环节都清晰易懂。

    在 Playground 中直观体验 Hailuo-03 API

    Playground 提供了可视化的测试环境，方便您在正式全面接入前体验文生视频（Text to Video）、图生视频（Image to Video）以及参考视频生成（Reference to Video）。您可在此更高效地调整与对比提示词、单张图像、首尾帧及多模态参考素材。

    面向生产环境的高可靠 Hailuo 3.0 API 基础设施

    稳定的服务接入，确保在开发、测试、部署及日常生产环境中都能获得一致的生成效果。Kie.ai 提供的 Hailuo 3.0 API 基础设施可轻松应对不断增长的请求量，用户无需自行维护视频生成环境。

    为 MiniMax H3 API 接入提供快速响应支持

    我们提供专业的客户支持，协助解决账号访问、接口文档、系统集成及生成相关的问题。MiniMax H3 API 用户在整个测试与生产阶段均可获得及时的技术指导，无需独自面对技术难题。

    探索 Hailuo AI API 之外的更多高级模型

    仅需一个 Kie.ai 账号，即可调用更丰富的视频、图像、音频和语言模型。除了 Hailuo AI API，用户还能横向对比不同模型的创作能力，扩展现有产品，并新增生成式工作流，完全无需重构底层技术架构。

    MiniMax H3 API 常见问题解答