flux-fill默认主题
语言
图像
FLUX.1 Fill API — 如何接入并付费
FLUX.1 Fill — Black Forest Labs 的图像修复模型:通过蒙版重绘图像区域(移除对象、替换背景、扩展场景)。需要源图像和黑白蒙版。
渠道对比
最近 7 天
渠道
画布
价格
$0.053333 起 per image
| 渠道 | 价格 |
|---|---|
画布 flux-fill默认 | $0.053333 起 per image |
组合你需要的输出结果
flux-fill输入: 文本, 图像某些模式需要附加: source image, mask (url, black-and-white, same size), seed for reproducibility
什么是 FLUX.1 Fill
FLUX.1 Fill — Black Forest Labs 的图像修复模型:通过蒙版重绘图像区域(移除对象、替换背景、扩展场景)。需要源图像和黑白蒙版。
契约概览
- 输入
- 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":"flux-fill","prompt":"a beautiful landscape","opts":{"tier":"dev","image_url":"https://example.com/image_url.png","mask_url":"https://example.com/mask_url.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": "flux-fill",
"prompt": "a beautiful landscape",
"opts": {
"tier": "dev",
"image_url": "https://example.com/image_url.png",
"mask_url": "https://example.com/mask_url.png"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API 请求参数
通过 GetVibe API 向 FLUX.1 Fill 发起请求的参数。
参数
prompt必填类型
text
取值
text description
默认值
required
价格
—
参数
image_url类型
URL
取值
Public image URL
默认值
—
价格
—
参数
tier类型
option selection
取值
dev (fast) (default) · pro (max quality)
默认值
dev(快速)
价格
dev (fast): $0.053333, pro (max quality): $0.066667
参数
mask_url必填类型
text / number
取值
any value
默认值
—
价格
Included in the base price
参数
seed类型
text / number
取值
any value
默认值
—
价格
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
参数
mask_file_id类型
text
取值
Alternative to mask_url: the id of your own file from POST /v1/files (file-pv-…)
默认值
—
价格
Included in the base price
参数
mask_base64类型
text
取值
Alternative to mask_url: the file inline, as base64 or a data: URI
默认值
—
价格
Included in the base price
| 参数 | 类型 | 取值 | 默认值 | 价格 |
|---|---|---|---|---|
prompt必填 | text | text description | required | — |
image_url | URL | Public image URL | — | — |
tier | option selection | dev (fast) (default) · pro (max quality) | dev(快速) | dev (fast): $0.053333, pro (max quality): $0.066667 |
mask_url必填 | text / number | any value | — | Included in the base price |
seed | text / number | any value | — | 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 |
mask_file_id | text | Alternative to mask_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
mask_base64 | text | Alternative to mask_url: the file inline, as base64 or a data: URI | — | Included in the base price |
请求:POST https://getvibeapi.com/api/media/generate。价格以 USD 计。
FLUX.1 Fill 的价格
FLUX.1 Fill 的费用:从 $0.053333 per image。价格按当前汇率动态计算,最终扣费见 API 响应(priceRub)。以 USD 支付,无订阅。
默认请求的实际费用
若不传参数,请求将使用这些取值:Version and quality — dev (fast)。 该请求的费用为 $0.053333。
各渠道及所有参数组合的价格
每个渠道的每种参数组合价格。这正是成功生成时扣除的金额,与下方链接的机器可读价格表一致。
画布flux-fill$0.053333 起精确价格
| 版本 | dev(快速) | pro(最高质量) |
|---|---|---|
| 画布 | $0.053333 | $0.066667 |
所有组合(JSON): /api/media/price-table?model=flux-fill
README
FLUX.1 Fill 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。
# FLUX.1 Fill
公开模型:flux-fill
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}
## 输入参数
- `prompt` (text): text description; 默认: required
- `image_url` (URL): Public image URL; 默认: —
- `tier` (option selection): dev (fast) (default) · pro (max quality); 默认: dev (fast)
- `mask_url` (text / number): any value; 默认: —
- `seed` (text / number): any value; 默认: —
- `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; 默认: —
- `mask_file_id` (text): Alternative to mask_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `mask_base64` (text): Alternative to mask_url: the file inline, as base64 or a data: URI; 默认: —
## 公开变体
- `flux-fill`: Canvas关于 FLUX.1 Fill API 的常见问题
FLUX.1 Fill 的价格是多少?
FLUX.1 Fill 的价格:从 $0.053333 per image。价格按当前汇率动态计算。
是否兼容 OpenAI SDK?
是的,API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。