minimax-h3-image默认Minimax H3 Image API — 如何接入并付费
MiniMax H3 Image — 图像生成与编辑。支持 1K/2K/4K(最高约 16 MP)或自定义宽度×高度(0.66–20 MP,单边最高 8192 px),支持 10 种宽高比及自动模式。编辑支持输入 1–16 张参考图像;每张参考图像的费用为 0.5 积分。默认启用提示词扩展;输出格式为 PNG 或 JPEG;可选设置 seed。
渠道对比
最近 7 天
| 渠道 | 价格 |
|---|---|
Pixel minimax-h3-image默认 | $0.012 起 per image |
组合你需要的输出结果
minimax-h3-image什么是 Minimax H3 Image
MiniMax H3 Image — 图像生成与编辑。支持 1K/2K/4K(最高约 16 MP)或自定义宽度×高度(0.66–20 MP,单边最高 8192 px),支持 10 种宽高比及自动模式。编辑支持输入 1–16 张参考图像;每张参考图像的费用为 0.5 积分。默认启用提示词扩展;输出格式为 PNG 或 JPEG;可选设置 seed。
契约概览
- 输入
- text, image
- 输出
- image
- 模式
- 异步(任务 + 轮询)
- 状态轮询
- 每 3 秒 · 最多 90 秒
优势
- 定价:按图像计费
- 输入:文本、图像
- 2 个可配置选项
- 用于媒体生成的一个 API 密钥
应用场景
- 文章和社交媒体插图
- 产品图像
- 横幅和封面
- 设计原型
API 契约
生成是异步的:先创建任务,然后轮询状态直至完成。
- 创建任务
- POST /api/media/generate
- 检查状态
- GET /api/media/jobs/{jobId}
- 输入
- text, image
- 输出
- image
- 轮询
- 每 3 秒 · 最多 90 秒
- 鉴权
- Authorization: Bearer sk-pv-…
请求示例
在 Bearer 请求头中传递密钥。API 会返回 jobId 用于轮询状态。
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"minimax-h3-image","prompt":"a beautiful landscape","opts":{"mode":"text-to-image","aspect_ratio":"auto","resolution":"2K","expand_prompt":true,"output_format":"png"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "minimax-h3-image",
"prompt": "a beautiful landscape",
"opts": {
"mode": "text-to-image",
"aspect_ratio": "auto",
"resolution": "2K",
"expand_prompt": true,
"output_format": "png"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API 请求参数
通过 GetVibe API 向 Minimax H3 Image 发起请求的参数。
prompt必填image_urlmodeaspect_ratioresolutionwidthheightexpand_promptoutput_formatseedimage_urlsimage_file_idimage_base64input_file_ids| 参数 | 类型 | 取值 | 默认值 | 价格 |
|---|---|---|---|---|
prompt必填 | text | text description | required | — |
image_url | URL | Public image URL | — | — |
mode | option selection | Generate (text → image) (default) · Edit (image → image) | 生成(文本 → 图像) | Generate (text → image): $0.012, Edit (image → image): $0.015333 |
aspect_ratio | option selection | Auto (default) · 1:1 · 5:4 · 4:3 · 3:2 · 16:9 · 21:9 · 4:5 · 3:4 · 2:3 · 9:16 | 自动 | Included in the base price |
resolution | option selection | 1K (~1 MP) · 2K (~4 MP) (default) · 4K (~16 MP) | 2K (~4 MP) | 1K (~1 MP): $0.012, 2K (~4 MP): $0.012, 4K (~16 MP): $0.036667 |
width | text / number | any value | — | Included in the base price |
height | text / number | any value | — | Included in the base price |
expand_prompt | yes/no | Yes (default) · No | 是 | Included in the base price |
output_format | option selection | PNG (default) · JPEG | PNG | Included in the base price |
seed | text / number | any value | — | Included in the base price |
image_urls | Array<URLs>, 0–16 items | Public HTTP(S) URLs | — | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
input_file_ids | Array<strings> | List of values | — | Included in the base price |
请求:POST https://getvibeapi.com/api/media/generate。价格以 USD 计。
Minimax H3 Image 的价格
Minimax H3 Image 的费用:从 $0.012 per image。价格按当前汇率动态计算,最终扣费见 API 响应(priceRub)。以 USD 支付,无订阅。
默认请求的实际费用
若不传参数,请求将使用这些取值:Resolution — 2K (~4 MP), Mode — Generate (text → image), Frame format — Auto, Enhance prompt (on by default) — Yes。 该请求的费用为 $0.012。
各渠道及所有参数组合的价格
每个渠道的每种参数组合价格。这正是成功生成时扣除的金额,与下方链接的机器可读价格表一致。
Pixelminimax-h3-image$0.012 起精确价格
| 模式 \ 分辨率 | 1K (~1 MP) | 2K (~4 MP) | 4K (~16 MP) |
|---|---|---|---|
| 生成(文本 → 图像) | $0.012 | $0.012 | $0.036667 |
| 编辑(图像 → 图像) | $0.015333 | $0.015333 | $0.04 |
所有组合(JSON): /api/media/price-table?model=minimax-h3-image
README
Minimax H3 Image 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。
# Minimax H3 Image
公开模型:minimax-h3-image
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}
## 输入参数
- `prompt` (text): text description; 默认: required
- `image_url` (URL): Public image URL; 默认: —
- `mode` (option selection): Generate (text → image) (default) · Edit (image → image); 默认: Generate (text → image)
- `aspect_ratio` (option selection): Auto (default) · 1:1 · 5:4 · 4:3 · 3:2 · 16:9 · 21:9 · 4:5 · 3:4 · 2:3 · 9:16; 默认: Auto
- `resolution` (option selection): 1K (~1 MP) · 2K (~4 MP) (default) · 4K (~16 MP); 默认: 2K (~4 MP)
- `width` (text / number): any value; 默认: —
- `height` (text / number): any value; 默认: —
- `expand_prompt` (yes/no): Yes (default) · No; 默认: Yes
- `output_format` (option selection): PNG (default) · JPEG; 默认: PNG
- `seed` (text / number): any value; 默认: —
- `image_urls` (Array<URLs>, 0–16 items): Public HTTP(S) URLs; 默认: —
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; 默认: —
- `input_file_ids` (Array<strings>): List of values; 默认: —
## 公开变体
- `minimax-h3-image`: Pixel关于 Minimax H3 Image API 的常见问题
Minimax H3 Image 的价格是多少?
Minimax H3 Image 的价格:从 $0.012 per image。价格按当前汇率动态计算。
是否兼容 OpenAI SDK?
是的,API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。