Mage API · 视频模型
MiniMax-H3 API
带立体声的快速开放视频生成
POST https://api.mage.space/v1/minimax_h3/generate一览
MiniMax-H3 API 通过 Mage 运行 Pika H3 Flex 及另外 2 个变体,接口为 POST https://api.mage.space/v1/minimax_h3/generate。使用默认设置的一次请求费用为 45 Gems(约 $0.045),无需订阅。MiniMax-H3 支持在提示词中通过 @handle 调用已保存的角色(Characters)、参考(References)和音频参考。
- 视频输出
- 3变体
- 45每段视频消耗的 Gems(默认)
- $0.045约合美元
概览
MiniMax-H3 API 能做什么
一款快速的开放视频模型,可同时生成画面和立体声音频。支持首尾帧或最多 8 个参考(片段越长,可用参考越少),时长 5 到 15 秒,分辨率最高 768p。
一款快速的开放视频模型,可同时生成视频和立体声音频。
支持的输入:first_image、last_image、image、additional_images、videos。
快速开始
调用 MiniMax-H3 API
设置 MAGE_API_KEY,向 /minimax_h3/generate 提交请求,然后轮询 status_url,直到请求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "pika-h3-flex"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('minimax_h3', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'pika-h3-flex',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("minimax_h3", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "pika-h3-flex",
})
print(request["result"]["url"])模型
MiniMax-H3 的 model_id 取值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| minimax-h3-turbo | MiniMax-H3 Turbo | |
| pika-h3-flex | Pika H3 Flex | 是 |
| minimax-h3 | MiniMax-H3 |
选项
MiniMax-H3 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 480p, 544p, 720p, 768p |
| duration | 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
输入
MiniMax-H3 支持的媒体输入
可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。
| 字段 | 用途 |
|---|---|
| first_image | 首帧图片。 |
| last_image | 尾帧图片。 |
| image | 参考图片。 |
| additional_images | 额外的参考图片。 |
| videos | 源视频。 |
规则
MiniMax-H3 API 的限制
- 首帧和尾帧不能与参考图片或参考视频同时使用:只能发送其中一种。
- 最多 9 张参考图片和 3 段参考视频,每段 2 到 15 秒。
- 参考内容与片段共用 21 秒的额度:`duration`,加上每张参考图片、每个被提及的角色和每个被提及的参考各 2 秒,再加上每段参考视频每秒 1.15 秒(最多计到 `duration`),总和不得超过 21。
更多视频模型
Mage 上的其他视频生成 API
Plum API
每段视频都带声音,最高支持 2K
Raspberry API
从首帧让角色动起来
Seedance API
Seedance,内容过滤严格
Wan 3.0 API
Wan 3.0,内容过滤严格
Wan Video v2.2 API
开放权重视频模型,含 Lightning 版本
Berry API
忠实还原你的参考内容的视频
常见问题
常见问题解答
MiniMax-H3 API 的费用是多少?
使用默认设置(Pika H3 Flex)的一次 MiniMax-H3 请求费用为 45 Gems,约 $0.045。其他分辨率、时长和变体会影响价格,具体扣费以返回结果为准。生成失败会退还 Gems;若因违反 Mage 内容政策而被拦截,则不予退还。
MiniMax-H3 API 的端点是什么?
向 https://api.mage.space/v1/minimax_h3/generate 发送 POST 请求,并在 Authorization: Bearer 请求头中携带你的 Mage API 密钥。返回结果中包含 status_url,用于轮询获取结果。
可以调用哪些 MiniMax-H3 模型?
minimax-h3-turbo(MiniMax-H3 Turbo)、pika-h3-flex(Pika H3 Flex)、minimax-h3(MiniMax-H3)。默认为 Pika H3 Flex。
MiniMax-H3 支持参考图片或角色吗?
MiniMax-H3 支持 first_image、last_image、image、additional_images、videos。在提示词中通过 @handle 即可使用已保存的角色、参考和音频参考。
可以在 Claude 或 ChatGPT 中使用 MiniMax-H3 吗?
可以。将 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接点名要用 MiniMax-H3。你的助手会通过 get_model 读取可用选项,并在生成前告知价格。
MiniMax-H3 的生成结果会保存多久?
结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。