Flux.2 文生图服务说明

服务简介

Flux.2 文生图服务是一项基于自然语言提示词生成图片的能力服务。调用方提交提示内容及相关图像参数后，服务会执行图像生成任务，并在任务完成后返回对应的生成结果信息。

该服务适合用于二次封装后集成到以下场景中：

• 图片生成类应用
• 智能 Bot / Agent 出图能力
• 内容创作平台
• 海报、插画、概念图生成系统
• 内部测试与批量提示词实验平台

对于需要封装成统一能力接口的平台来说，该服务可作为底层图像生成引擎，为上层系统提供标准化的图片生成结果。

---

服务特性

• 支持根据文本提示词生成图片
• 支持返回完整生成结果信息
• 支持自定义图像尺寸与生成参数
• 返回原图路径与缩略图路径
• 返回本次生成所使用的随机种子 seed
• 返回本次消耗积分及剩余额度信息

---

服务能力说明

Flux.2 文生图服务的核心能力是：
根据输入的自然语言描述生成对应图片，并输出与本次生成任务相关的结果数据，便于上层系统进一步处理、展示、记录或复用。

该服务生成完成后，通常会提供以下内容：

• 图片原图路径
• 图片缩略图路径
• 实际使用的提示词
• 图片宽高信息
• 本次生成种子值
• 本次消耗积分
• 剩余可用积分

这些结果适合用于：

• 前端页面图片展示
• 列表页缩略图展示
• 图片生成记录存档
• 种子复现与结果追踪
• 额度统计与计费展示

---

返回结果说明

当图片生成完成后，返回结果中会包含 result 对象。
该对象用于描述本次图片生成任务的最终结果。

返回结果字段如下：

success

类型：boolean
说明：表示本次图片是否生成成功。

image

类型：string
说明：原图访问路径。

thumbnail

类型：string
说明：缩略图访问路径。

prompt

类型：string
说明：本次实际使用的提示词内容。

width

类型：number
说明：生成图片的宽度。

height

类型：number
说明：生成图片的高度。

seed

类型：number
说明：本次生成任务使用的随机种子值，可用于结果追踪与复现参考。

creditsUsed

类型：number
说明：本次生成所消耗的积分。

creditsRemaining

类型：number
说明：当前剩余积分。

---

返回结果示例

{
"success": true,
"image": "/outputs/xxx.png",
"thumbnail": "/outputs/thumb_xxx.jpg",
"prompt": "...",
"width": 1024,
"height": 1024,
"seed": 123456789,
"creditsUsed": 0,
"creditsRemaining": 999999
}

---

图片访问方式说明（重点）

这里需要特别说明：

返回结果中的 image 和 thumbnail 字段，通常表示的是资源路径，并不是可直接访问的完整网址。

也就是说，返回值中的：

/outputs/xxx.png
/outputs/thumb_xxx.jpg

本质上只是路径。

最终要访问图片，必须使用“网址 + 路径”的方式拼接成完整地址。

例如，当服务基础网址为：

https://ptp.matrixlabs.cn

那么：

原图完整访问地址为：
https://ptp.matrixlabs.cn/outputs/xxx.png

缩略图完整访问地址为：
https://ptp.matrixlabs.cn/outputs/thumb_xxx.jpg

因此，在对外二次封装时，建议明确约定：

最终图片访问地址 = 服务网址 + 返回路径

这一点非常重要，建议在封装层直接处理为完整 URL 后再返回给下游系统，避免调用方误把路径当成完整地址使用。

---

结果使用建议

返回结果中的各字段可按如下方式使用：

• image：用于图片详情展示、原图预览、下载等场景
• thumbnail：用于列表页、卡片流、缩略图预览等场景
• prompt：用于记录生成内容，便于审计与复查
• seed：用于结果复现、问题排查与生成记录归档
• creditsUsed：用于本次资源消耗记录
• creditsRemaining：用于额度展示或剩余额度判断

如果该服务需要再次封装为统一 API，建议在封装层保留这些原始字段，方便上层业务系统直接消费。