参数
image_url类型
URL
取值
Public image URL
默认值
—
价格
—
GetVibeAPI主题
语言
视频
Minimax H3 MAX Relight API — 如何接入并付费
MiniMax H3 Max Relight——根据光照参考图为现有视频（最长 15 秒）重新布光：参考图像是一个按照您期望的方式照明的球体。场景和运动保持不变，仅改变光线。480p / 768p / 1080p / 2K。按源视频的秒数计费。
组合你需要的输出结果
minimax-h3-max-relight该模型在目录中仅公布最低价格。
输入： 视频, 图像某些模式需要附加： source video, lighting reference (url of a sphere render), seed for reproducibility
什么是 Minimax H3 MAX Relight
MiniMax H3 Max Relight——根据光照参考图为现有视频（最长 15 秒）重新布光：参考图像是一个按照您期望的方式照明的球体。场景和运动保持不变，仅改变光线。480p / 768p / 1080p / 2K。按源视频的秒数计费。
契约概览
- 输入
- video, image
- 输出
- video
- 模式
- 异步（任务 + 轮询）
- 状态轮询
- 每 3 秒 · 最多 600 秒
优势
- 定价：按秒计费
- 输入：视频、图像
- 4 个可配置选项
- 用于媒体生成的一个 API 密钥
应用场景
- 社交媒体片段
- 宣传片和片头序列
- 静态图像动画
- 故事板和动态分镜
API 契约
生成是异步的：先创建任务，然后轮询状态直至完成。
- 创建任务
- POST /api/media/generate
- 检查状态
- GET /api/media/jobs/{jobId}
- 输入
- video, image
- 输出
- video
- 轮询
- 每 3 秒 · 最多 600 秒
- 鉴权
- 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-max-relight","opts":{"video_url":"https://example.com/video_url.mp4","reference_image_url":"https://example.com/reference_image_url.png","resolution":"768p","aspect_ratio":"adaptive"}}'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-max-relight",
"opts": {
"video_url": "https://example.com/video_url.mp4",
"reference_image_url": "https://example.com/reference_image_url.png",
"resolution": "768p",
"aspect_ratio": "adaptive"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API 请求参数
通过 GetVibe API 向 Minimax H3 MAX Relight 发起请求的参数。
参数
video_url类型
URL
取值
Public video URL
默认值
—
价格
—
参数
reference_image_url必填类型
text / number
取值
any value
默认值
—
价格
Included in the base price
参数
resolution类型
option selection
取值
480p · 768p (default) · 1080p · 2K
默认值
768p
价格
Included in the base price
参数
aspect_ratio类型
option selection
取值
Match source (default) · 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16
默认值
Match source
价格
Included in the base price
参数
seed类型
text / number
取值
any value
默认值
—
价格
Included in the base price
参数
video_file_id类型
text
取值
Alternative to video_url: the id of your own file from POST /v1/files (file-pv-…)
默认值
—
价格
Included in the base price
参数
video_base64类型
text
取值
Alternative to video_url: the file inline, as base64 or a data: URI
默认值
—
价格
Included in the base price
| 参数 | 类型 | 取值 | 默认值 | 价格 |
|---|---|---|---|---|
image_url | URL | Public image URL | — | — |
video_url | URL | Public video URL | — | — |
reference_image_url必填 | text / number | any value | — | Included in the base price |
resolution | option selection | 480p · 768p (default) · 1080p · 2K | 768p | Included in the base price |
aspect_ratio | option selection | Match source (default) · 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 | Match source | Included in the base price |
seed | text / number | any value | — | Included in the base price |
video_file_id | text | Alternative to video_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
video_base64 | text | Alternative to video_url: the file inline, as base64 or a data: URI | — | Included in the base price |
请求：POST https://getvibeapi.com/api/media/generate。价格以 USD 计。
Minimax H3 MAX Relight 的价格
Minimax H3 MAX Relight 的费用：从 $0.106667 per second。价格按当前汇率动态计算，最终扣费见 API 响应（priceRub）。以 USD 支付，无订阅。
默认请求的实际费用
若不传参数，请求将使用这些取值：Resolution — 768p, Frame format — Match source。 该请求的费用为 $0.106667。
README
Minimax H3 MAX Relight 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。
# Minimax H3 MAX Relight
公开模型：minimax-h3-max-relight
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}
## 输入参数
- `image_url` (URL): Public image URL; 默认: —
- `video_url` (URL): Public video URL; 默认: —
- `reference_image_url` (text / number): any value; 默认: —
- `resolution` (option selection): 480p · 768p (default) · 1080p · 2K; 默认: 768p
- `aspect_ratio` (option selection): Match source (default) · 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16; 默认: Match source
- `seed` (text / number): any value; 默认: —
- `video_file_id` (text): Alternative to video_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `video_base64` (text): Alternative to video_url: the file inline, as base64 or a data: URI; 默认: —
## 公开变体
- `minimax-h3-max-relight`: 默认关于 Minimax H3 MAX Relight API 的常见问题
Minimax H3 MAX Relight 的价格是多少？
Minimax H3 MAX Relight 的价格：从 $0.106667 per second。价格按当前汇率动态计算。
是否兼容 OpenAI SDK？
是的，API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。