video_generate.minimax_h3_i2v
minimax/minimax-h3/image-to-video
image-to-video

MiniMax H3 API 用一张输入图加一段文本提示词生成动画视频——2K 画质，6 或 10 秒，七种纵横比（16:9、4:3、1:1、3:4、9:16、21:9 或 adaptive，默认后者），提示词最长 7000 字符——全部通过兼容 OpenAI 的单一 REST 接口完成。

输入
发送给模型的文本提示词
输出
Sample edited image — run the model to replace this previewSampleRun the model to replace this preview

MiniMax H3 API：图生视频

给一张图和一段提示词，让画面动起来 —— 2K，6 或 10 秒，七种画幅。

MiniMax H3 API（minimax/minimax-h3-i2v）把一张静态图变成一段视频：你提供起始画面和一段描述运动的提示词，模型据此推演后续帧。这是 MiniMax 自研模型，走官方渠道直接接入。image_urls 与 prompt 都是必填；时长 6 或 10 秒，默认 6 秒；画幅在 16:9、4:3、1:1、3:4、9:16、21:9 与 adaptive 之间选，默认 adaptive，也就是跟随输入图自身的比例；输出固定 2K。提示词最长 7000 字符。

计费方式是MiniMax H3 API 按次计费：6 秒每段 ¥0.678，10 秒每段 ¥1.13，没有单次请求附加费。对电商与广告场景来说，这意味着一张产品图可以跑出多种运镜方案，逐条比对后再决定投放。MiniMax H3 API 异步且兼容 OpenAI：POST /v1/videos/generations 带上 image_urls 与 prompt，轮询 GET /v1/videos/generations/{id} 直到 status=success，从签名 CDN 链接取回成片。默认的 adaptive 让输出比例与原图一致，省掉一次裁剪。

为什么选这个模型

团队选择 MiniMax H3 API 的六个理由

从提示词到 2K 成片 —— MiniMax H3 API 在生产环境里的六个特点。

从你的图开始

首帧就是你传入的图片，MiniMax H3 API 负责让它动起来 —— 主体、构图与配色都保留，不会被重新想象一遍。

MiniMax 官方渠道

H3 是 MiniMax 自研模型，通过官方接口接入，不经第三方转售。上下文限制与计费口径都与官方一致。

运动由提示词控制

在 prompt 里写清镜头怎么走、主体怎么动，最长 7000 字符。MiniMax H3 API 据此推演，而不是随机生成动作。

默认贴合原图比例

MiniMax H3 API 的画幅默认 adaptive，输出跟随输入图；也可以在 16:9、4:3、1:1、3:4、9:16、21:9 里指定，一次调用换好版位。

固定 2K 输出

MiniMax H3 API 每段输出都是 2K，没有画质档要选。草稿与终稿同一分辨率，省掉一轮放大。

按次计费

MiniMax H3 API 按片计价：6 秒 ¥0.678、10 秒 ¥1.13，无附加费。一张图跑多种运镜方案的成本完全可预估。

RouterBase dashboard preview
快速上手

三步开始使用 MiniMax H3 API

从拿到 key 到第一次调用，5 分钟以内。

  1. 准备首帧图与提示词

    把起始图片放到可公开访问的地址填进 image_urls，在 prompt 里描述希望发生的运动与镜头变化。MiniMax H3 API 要求这两个字段都必填。

  2. 调用 MiniMax H3 API

    向 POST /v1/videos/generations 传 image_urls、prompt，以及可选的 duration 与 aspect_ratio。想让输出保持原图比例就用默认的 adaptive。

  3. 轮询并取回视频

    轮询 GET /v1/videos/generations/{id} 直到 status=success，从 results 里的签名 CDN 链接下载成片，可直接用于投放。

Get API Key Read docs
定价

按使用量付费

VibeToken 透传合作方价格，与模型官方公开 API 价格对比。

分辨率VibeToken
6s / 2K ¥0.678
10s / 2K ¥1.130

本次请求费用 ¥0.678（6s / 2K）。¥1 大约可以调用本模型 1 次。

MiniMax H3 API 的价格取 MiniMax 官方公布的刊例价，按次计费，无单次请求附加费。

客户故事

团队用 MiniMax H3 API 构建了什么

真实生产负载运行在 MiniMax H3 API 上。

Marcus Reyes
Marcus ReyesCTO, Paradigm AI

产品图直接进 MiniMax H3 API，出来就是能投的短视频。不用重拍，也不用请后期。

Priya Lakshmi
Priya LakshmiFounder, Quillo

MiniMax H3 API 默认贴合原图比例这点很省事，竖版素材传进去出来还是竖版，省掉一次裁剪。

Thomas Beck
Thomas BeckStaff Engineer, Northbeam

一张定妆图在 MiniMax H3 API 上跑五种运镜，挑最好的那条上线。成本低到可以这么试。

Aoi Tanaka
Aoi TanakaML Lead, Daybreak Robotics

我们把商品主图批量喂给 MiniMax H3 API，一晚上出几百条素材，第二天直接 A/B。

Jonas Keller
Jonas KellerIndie Developer

图进，视频出。提示词只写镜头怎么动，剩下的 MiniMax H3 API 自己推。

Ethan Nguyen
Ethan NguyenHead of Engineering, Compound Studio

接入只改了 model ID 和两个字段，MiniMax H3 API 和目录里其他模型是同一套结构。

Sophia MartinCTO, Relay

六秒足够做信息流首屏，十秒留给详情页。同一张图在 MiniMax H3 API 上两种时长都跑一遍就行。

Lucas Fernandes
Lucas FernandesEngineering Manager, Light

按次计费让预算好算，每周几千条也不会有意外账单。

David Okonkwo
David OkonkwoCo-founder, Figment

官方渠道接入这点对我们很重要，版本更新不用等中间商排期。

常见问题

关于 MiniMax H3 API 图生视频任务的常见问题。

它以你提供的图片作为首帧，按提示词描述的运动推演出后续画面，生成一段视频。主体和构图来自原图，不是重新生成。