gpt-image-2
通用图片生成模型，适合大多数文生图和图生图任务。
FluAPI · Image API
Image API
one endpoint, three models.
使用兼容 OpenAI Images 风格的接口，通过 https://new.fluapi.com/v1 调用 gpt-image-2、gpt-image-2.5 和 gpt-image-2.5-ultra-fast。
Base URL https://new.fluapi.com/v1格式 JSON · multipart鉴权 Bearer API key
快速开始
API Key 放在服务端环境变量或请求头中。不要把 Key 写进浏览器代码、前端构建产物或公开仓库。
POST
https://new.fluapi.com/v1/images/generations文生图：发送 JSON 到
/images/generations。图生图：发送 multipart/form-data 到 /images/edits。两者都使用同一个 Bearer Token。curl · text-to-image
curl https://new.fluapi.com/v1/images/generations \ -H "Authorization: Bearer $FLU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "一只戴黄色雨衣的海鸥，电影感灯光", "n": 1, "size": "2048x1152", "quality": "medium" }'
可用模型
三个模型共享同一套接口和请求字段。使用 GET /models 检查当前 API Key 可见的模型列表。
gpt-image-2.5
面向高细节和稳定构图的图片生成模型。
gpt-image-2.5-ultra-fast
面向交互式预览和低等待场景的快速模型。
GET · list models
curl https://new.fluapi.com/v1/models \ -H "Authorization: Bearer $FLU_API_KEY"
请求参数
下面是直接发送给 FluAPI 的上游字段。字段名和枚举值区分大小写时，按示例传递。
| 字段 | 类型 | 接口 | 说明 |
|---|---|---|---|
| model | string | 必填 | gpt-image-2、gpt-image-2.5 或 gpt-image-2.5-ultra-fast。 |
| prompt | string | 必填 | 图片描述文本，不能为空。建议写清主体、动作、构图、镜头、光线和风格。 |
| quality | string | 可选 | low、medium、high。不传时使用服务默认值。 |
| size | string | 可选 | 宽x高 像素字符串，例如 1024x1024、2048x1152、2160x3840。 |
| n | integer | 可选 | 返回图片数量。建议从 1 开始；可用范围由账户和上游策略决定。 |
常用尺寸示例
| 用途 | 比例 | 示例 size |
|---|---|---|
| 方形头像 / 图标 | 1:1 | 1024x1024 或 2048x2048 |
| 横向图片 | 16:9 | 1536x864 或 2048x1152 |
| 纵向海报 | 9:16 | 1152x2048 或 2160x3840 |
尺寸是 WxH 字符串，不要传 ratio 或 resolution 代替 size。如果某个尺寸被账户策略拒绝，按错误消息调整尺寸。
代码示例
JavaScript · fetch
const response = await fetch('https://new.fluapi.com/v1/images/generations', { method: 'POST', headers: { Authorization: `Bearer ${process.env.FLU_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'gpt-image-2.5-ultra-fast', prompt: '极简白色产品摄影，柔和阴影', n: 1, size: '1536x1024', quality: 'low' }) }) const result = await response.json() if (!response.ok) throw new Error(result.error?.message || result.error || 'FluAPI request failed')
响应读取优先读取
data[0].url；如果返回 base64，则读取 data[0].b64_json。请求超时图片生成可能耗时较长，客户端设置 10 分钟级别的超时，并记录上游 request id。
图生图 / 图片编辑
将参考图片和文本字段作为 multipart/form-data 发送到 /images/edits。多张参考图重复使用 image 字段。
POST
https://new.fluapi.com/v1/images/editscurl · image-to-image
curl https://new.fluapi.com/v1/images/edits \ -H "Authorization: Bearer $FLU_API_KEY" \ -F "model=gpt-image-2.5" \ -F "prompt=保留人物身份，把背景改成雨夜东京街头" \ -F "n=1" -F "size=2048x1152" \ -F "quality=high" \ -F "image=@reference.png"
文件字段：参考图字段名是
image。文件必须是有效图片；文件数量、大小和可用格式以当前 API Key 的接口策略为准。响应与错误
成功响应使用 OpenAI Images 风格的 data 数组。每个元素通常包含图片 URL、base64 图片或修订后的提示词。
典型响应
{
"created": 1791280000,
"data": [{
"url": "https://.../generated.png",
"revised_prompt": "..."
}]
}| 状态 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求参数错误，例如缺少 prompt、模型名称或 size 不被接受。 | 修正请求后再发，不要无限重试。 |
| 401 | Invalid token / API Key 无效或已失效。 | 检查 Authorization: Bearer … 和 Key 权限。 |
| 413 | 请求体或参考素材过大。 | 压缩图片并减少参考图数量。 |
| 429 | 触发限流或账户额度限制。 | 降低并发，按 Retry-After 或指数退避重试。 |
| 500–504 | 上游服务暂时失败。 | 最多重试 2–3 次，并记录响应中的 request id。 |
上线检查
Key 管理只在后端调用，使用环境变量或密钥管理器注入。
日志记录模型、size、耗时、HTTP 状态和 request id，不记录完整 API Key。
URL 归档上游返回的 URL 可能有时效，需要长期保存时及时下载到自己的存储。
模型探测启动时调用
GET /models，根据返回列表决定可用模型。