Flux Dev Image to Image API

blackforestlabs/flux/dev/image-to-image
1 image · png/jpeg

Flux Dev Image to Image 基于 12B 参数流匹配扩散架构,结合单张参考图像与自然语言提示词生成全新画面,支持灵活的画布比例与多维度的视觉重塑能力。它在较好保持原图核心主体轮廓、空间透视与光影基调的前提下,能够自然融入材质置换、背景场景变换与艺术风格重绘指令。

Input
Output待生成

生成的图片将在这里显示

提交费用: 1 MP × 1 × 4 = 4 credits · $0.020

每个计费 MP 为 4 credits,再乘图片数量;1 credit = $0.005。

示例

Coastal Painted Study

A bold Fauvist oil painting on rough linen canvas of a golden dog running on a beach. PAINTING, not a photograph. Broad angular strokes of ochre, terracotta and cream construct the complete dog in SIDE PROFILE facing RIGHT, tail to the LEFT; keep the overall dog silhouette and beach subject from the reference. Four natural legs in a running stride. The entire animal fits comfortably in the lower half of the portrait canvas. Build the sea and sky from large flat patches of muted teal, pale blue and warm grey. Scraped palette-knife impasto, thick raised paint ridges, broken color and visible bristle marks across every part of the composition, simplified shapes, expressive brushwork, deliberately painterly edges. An unframed full-bleed fine-art painting with no decorative border, no lettering, no signature, no watermark.

Autumn Rain in the Courtyard

Use the supplied photograph as the fixed composition for a seasonal weather variation. Show the SAME entire dark-green step-through bicycle from the SAME SIDE VIEW: front wheel and wicker front basket on the LEFT, rear wheel and saddle on the RIGHT, two wheels side by side and both fully visible. Keep the pale plaster wall directly behind the bicycle, the wooden gate on the far LEFT and the leafy tree above the wall on the RIGHT. Preserve the original wide camera position, lens perspective, bicycle position and scale. Change only the weather, ground moisture and foliage: soft overcast autumn daylight, fine rain, wet stone paving with small puddles, scattered russet leaves, and amber foliage on the existing tree. Realistic gentle reflections, naturally aged materials and subtle rain streaks. A quiet residential courtyard, not an alley. Do not rotate the bicycle or move the camera. No rear view, no people, no extra bicycles, no text, no logos, no watermark.

Flux Dev Image to Image

Flux Dev Image to Image 是由 Black Forest Labs 研发的 120 亿参数(12B)流匹配图像转换模型。通过将单张公开参考图片与自然语言提示词结合,模型在保持输入画面主体轮廓、空间透视与光影基调的前提下,实现艺术风格迁移、材质置换与场景重绘。支持 6 种预设画幅及自定义像素尺寸,省略尺寸时由参考图引导并按 1:1 计费,输出 PNG 或 JPEG 格式,按每百万像素 4 积分($0.020/MP)计费,任务失败全额自动返还积分。

为什么选择 Flux Dev

  • 主体构图与轮廓保持在参考图像引导下进行重绘,保留原画面的主体空间位置、基础轮廓与环境光影基调。

  • 单图轻量化引导只需传入 1 个公网 HTTP(S) 图片链接即可建立视觉转换基准,工作流清晰高效。

  • 自然语言风格重塑通过文字提示词调整画面艺术材质、光照氛围与场景背景,实现多风格延展创作。

  • 灵活尺寸与格式支持默认继承参考图生成逻辑,亦支持显式传入预设画幅或自定义尺寸,支持 PNG 与 JPEG 输出。

  • 透明按量计费与退还保障基于实际输出画布像素按 4 积分/MP 计费,若任务因异常未能完成全额自动退还积分。

参数

参数要求说明
prompt必填

图片编辑与风格重绘指令,去除首尾空白后至少 1 个字符。

image_urls必填

包含恰好 1 个有效 HTTP(S) 参考图片链接的数组。

size可选

输出画布尺寸预设或 WIDTHxHEIGHT 正整数自定义像素尺寸。省略时由参考图画面自适应引导。

默认值1:11:1 HD4:33:416:99:16WIDTHxHEIGHT
n可选

输出图片数量,取正整数,默认 1。

默认值1
output_format可选

输出图片格式,支持 png 或 jpeg,默认 png。

默认值pngjpeg

使用方法

  1. 提供 1 张公网参考图 URL在 image_urls 数组中传入一个可公开访问的 HTTP(S) 图片链接作为转换基准。

  2. 撰写转换与修改提示词用自然语言明确描述需要改变的风格、背景或材质,保留的主体特征无需赘述。

  3. 设定可选尺寸与输出格式可省略 size 由参考图引导,或显式传入目标尺寸,并选择 PNG 或 JPEG 输出格式。

  4. 提交生成任务并轮询状态发起 API 请求获取 task_id,随后轮询查询任务状态直至转为 finished。

  5. 获取并验收生成图片从任务返回结果中的 data.files[].file_url 直接提取并下载生成的重绘图像。

价格

按提交参数计费,每个计费 MP 为 4 credits($0.020)。每张图片的画布像素数换算为 MP 后向上取整,最低 1 MP,再乘 n;任务失败退还积分。

用量价格说明
单价4 credits/MP · $0.020/MP1 MP = 1,000,000 像素,逐张计算。
1:1 · 4:3 · 3:4 · 16:9 · 9:164 credits/张 · $0.020/张这些预设的单张计费量均为 1 MP。
1:1 HD · 1024x15368 credits/张 · $0.040/张这些尺寸的单张计费量均为 2 MP。
自定义尺寸max(1, ceil(W × H / 1,000,000)) × n × 4 credits使用提交的 size 和 n 计算。
图生图默认值4 × n credits表单省略 size,计费采用默认 1:1。JSON 中显式设置 size 会改变提交费用;编辑画面由参考图引导。

使用场景

  • 商品图场景置换与棚拍化将已有商品照片通过提示词变换背景环境与灯光氛围,降低商业摄影拍摄成本。

  • 人物与角色风格重塑基于已有肖像或角色参考图,更换服装风格、光线氛围或艺术画风。

  • 设计草图效果具象化以手绘线稿或简单构图图为基础,结合提示词生成逼真质感效果图。

  • 艺术流派与视觉风格迁移将摄影图片转换为油画、水彩、插画等不同艺术表现形式。

使用技巧

  • 在提示词中集中描述需要改变的元素与风格,希望保留的原图主体无需冗余重复。
  • 提供主体清晰、光线明朗的参考图像,有助于模型准确捕捉基础轮廓与构图。
  • 若需要在重绘画面中加入文字,同样可使用英文双引号标注,指引文字排版生成。
  • 输出尺寸比例尽量与参考图比例相近,避免产生非预期的画面裁切或拉伸。
  • 日常预览建议选用体积更小的 jpeg 格式,需要高质量无损素材时选用 png 格式。

使用说明

  • 参考图输入约束:image_urls 数组必须包含且仅能包含 1 个有效的 HTTP(S) 图片链接。
  • 提示词必填约束:prompt 为必填参数,去除首尾空白后至少包含 1 个有效字符。
  • 尺寸与计费规则:省略 size 时由参考图引导并按默认 1:1(4 积分)计费;显式设置尺寸按目标像素计费。
  • 任务失败自动退还:若生成任务因异常未能成功完成,系统将全额自动返还所扣积分。

相关模型

Flux Dev Image to Image API 常见问题

Flux Dev Image to Image API 是什么?

Flux Dev Image to Image 是 Black Forest Labs 研发的 120 亿参数图像转换与风格编辑模型。它结合单张公开参考图片与自然语言提示词生成全新画面,在保持原图核心主体轮廓、空间构图与光影基调的前提下,实现风格迁移、材质置换与场景重绘。基于流匹配扩散变换器(Rectified Flow Transformer)与引导蒸馏技术,它确保在重绘过程中保持画面结构的协调连贯。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Flux Dev Image to Image 对输入参考图片有什么要求?

参考图片需以包含 1 个公开有效 HTTP 或 HTTPS 链接的数组形式传入 image_urls 参数中。链接应指向常见的标准静态图片文件(如 PNG 或 JPEG 格式)。

Flux Dev Image to Image 如何确定输出图片的尺寸?

在请求中省略 size 参数时,API 会以参考图画面为基准生成,计费按默认 1:1(单张 4 积分)计算;若需要固定画幅,亦可在请求中显式指定 16:9 等预设或 WIDTHxHEIGHT 自定义像素尺寸。

Flux Dev Image to Image 如何在转换时较好保持原图主体?

建议在提示词中集中描述需要修改或新增的风格、材质与背景内容,避免在文本中对希望保留的主体原有特征进行过多琐碎描写;同时使用主体清晰、光影分明的参考图以获得更稳定的引导效果。

Flux Dev Image to Image 的生成费用是多少?

计费标准与文生图一致,为每个计费百万像素(MP)4 积分($0.020/MP)。省略 size 或选用 1:1、4:3、16:9 与 9:16 预设均为 4 积分($0.020)/张,1:1 HD 为 8 积分($0.040)/张。若任务异常未能完成,积分全额自动退还。

需要传入多张参考图时应选用哪个模型?

Flux Dev Image to Image 专注于单张参考图引导;若业务场景需要传入多张参考图片进行复合重绘或主体融合,建议使用支持最多 8 张参考图的 Flux 2 Pro Edit 模型。

Flux Dev Image to Image 支持哪些输出图片格式?

该端点支持 output_format 参数设置为 png 或 jpeg。若请求中省略该字段,系统默认返回 png 图片。

在没有参考图片时应该使用哪个端点?

当仅有纯文字创意、无需参考图片直接生成全新画面时,请使用专为纯文本提示词设计的 Flux Dev Text to Image 端点。