flux-3默认Flux 3 API — 如何接入并付费
FLUX 3 (Black Forest Labs) — 支持同步音频的视频模型:文本转视频、图像转视频和片段续接。720p/1080p,5–20 s。按分辨率和模式按秒计费。Draft 是快速预览渲染,仅支持 720p。
渠道对比
最近 7 天
| 渠道 | 价格 |
|---|---|
画布 flux-3默认 | $0.08 起 / 秒 |
组合你需要的输出结果
flux-3什么是 Flux 3
FLUX 3 (Black Forest Labs) — 支持同步音频的视频模型:文本转视频、图像转视频和片段续接。720p/1080p,5–20 s。按分辨率和模式按秒计费。Draft 是快速预览渲染,仅支持 720p。
契约概览
- 输入
- text, image, video
- 输出
- video
- 模式
- 异步(任务 + 轮询)
- 状态轮询
- 每 3 秒 · 最多 600 秒
优势
- 计费方式:按秒
- 输入:文本、图像、视频
- 3 个可配置选项
- 一个 API 密钥用于媒体生成
应用场景
- 社交媒体短片
- 宣传片和片头序列
- 静态图像动画
- 分镜和动态分镜
API 契约
生成是异步的:先创建任务,然后轮询状态直至完成。
- 创建任务
- POST /api/media/generate
- 检查状态
- GET /api/media/jobs/{jobId}
- 输入
- text, image, video
- 输出
- 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":"flux-3","prompt":"a beautiful landscape","opts":{"mode":"text-to-video","duration":"5","quality":"full","resolution":"720p","aspect_ratio":"auto","generate_audio":true}}'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": "flux-3",
"prompt": "a beautiful landscape",
"opts": {
"mode": "text-to-video",
"duration": "5",
"quality": "full",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API 请求参数
通过 GetVibe API 向 Flux 3 发起请求的参数。
prompt必填image_urlvideo_urlmodedurationqualityresolutionaspect_ratiogenerate_audioimage_file_idimage_base64video_file_idvideo_base64| 参数 | 类型 | 取值 | 默认值 | 价格 |
|---|---|---|---|---|
prompt必填 | text | text description | required | — |
image_url | URL | Public image URL | — | — |
video_url | URL | Public video URL | — | — |
mode | option selection | Text → video (default) · Image → video · Continue a clip | 文本 → 视频 | Text → video: $0.226667/s, Image → video: $0.226667/s, Continue a clip: $0.546667/s |
duration | option selection | 5 (default) · 6 · 8 · 10 · 15 · 20 | 5 | Included in the base price |
quality | option selection | Full (default) · Draft (fast and cheap) | Full | Full: $0.226667/s, Draft (fast and cheap): $0.08/s |
resolution | option selection | 720p (default) · 1080p | 720p | 720p: $0.226667/s, 1080p: $0.386667/s |
aspect_ratio | option selection | Auto (default) · 21:9 · 2:1 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 | 自动 | Included in the base price |
generate_audio | yes/no | Yes (default) · No | 是 | 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 |
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 计。
Flux 3 的价格
Flux 3 的费用:从 $0.08 per second。价格按当前汇率动态计算,最终扣费见 API 响应(priceRub)。以 USD 支付,无订阅。
默认请求的实际费用
若不传参数,请求将使用这些取值:Resolution and quality — Full, Resolution — 720p, Mode — Text → video, Duration — 5。 该请求的费用为 $1.133335。
$0.226667/秒 × 5 秒 = $1.133335
“$0.08 起”是最便宜的参数组合,并非默认请求的价格。
各渠道及所有参数组合的价格
每个渠道的每种参数组合价格。这正是成功生成时扣除的金额,与下方链接的机器可读价格表一致。
画布flux-3$0.08 起 / 秒精确价格
| 模式 · 质量 \ 分辨率 | 720p | 1080p |
|---|---|---|
| 文本 → 视频 · 完整 | $0.226667 / 秒 | $0.386667 / 秒 |
| 文本 → 视频 · 草稿(快速且经济) | $0.08 / 秒 | — |
| 图生视频 · 完整 | $0.226667 / 秒 | $0.386667 / 秒 |
| 图生视频 · 草稿(快速且低成本) | $0.08 / 秒 | — |
| 续接片段 · 完整 | $0.546667 / 秒 | $0.706667 / 秒 |
| 续接片段 · 草稿(快速且低成本) | $0.16 / 秒 | — |
所有组合(JSON): /api/media/price-table?model=flux-3
README
Flux 3 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。
# Flux 3
公开模型:flux-3
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}
## 输入参数
- `prompt` (text): text description; 默认: required
- `image_url` (URL): Public image URL; 默认: —
- `video_url` (URL): Public video URL; 默认: —
- `mode` (option selection): Text → video (default) · Image → video · Continue a clip; 默认: Text → video
- `duration` (option selection): 5 (default) · 6 · 8 · 10 · 15 · 20; 默认: 5
- `quality` (option selection): Full (default) · Draft (fast and cheap); 默认: Full
- `resolution` (option selection): 720p (default) · 1080p; 默认: 720p
- `aspect_ratio` (option selection): Auto (default) · 21:9 · 2:1 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16; 默认: Auto
- `generate_audio` (yes/no): Yes (default) · No; 默认: Yes
- `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; 默认: —
- `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; 默认: —
## 公开变体
- `flux-3`: Canvas关于 Flux 3 API 的常见问题
Flux 3 的价格是多少?
Flux 3 的价格:从 $0.08 per second。价格按当前汇率动态计算。
是否兼容 OpenAI SDK?
是的,API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。