Flu API Developer Docs
gpt-image-2 已验证可用
Production verified

gpt-image-2
图像生成 API

通过 Flu API 统一端点生成 1K、2K 与 4K 图像,支持方图、横图、竖图及多档质量参数。

Endpoint /v1/images/generations Billing $2 / image Output Base64 PNG
01 / QUICK START

快速调用

使用 Flu API Key 通过 Bearer Token 鉴权。生产请求统一使用 HTTPS Base URL:https://new.fluapi.com/v1

POST
https://new.fluapi.com/v1/images/generations
模型
gpt-image-2
鉴权方式
Bearer API Key
超时建议
300–600 秒
单张费用
$2.00
API Key 只能保存在服务端环境变量或密钥管理系统中,不要写入浏览器 JavaScript、公开仓库或移动端安装包。
curl --request POST \
  --url 'https://new.fluapi.com/v1/images/generations' \
  --max-time 600 \
  --header 'Authorization: Bearer sk-YOUR_FLU_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "gpt-image-2",
    "prompt": "一台悬浮在纯白摄影棚中的未来感精密设备,黑色金属材质,青色光线,商业产品摄影",
    "n": 1,
    "size": "2048x2048",
    "quality": "high",
    "output_format": "png",
    "background": "opaque"
  }'
import base64
import os
from pathlib import Path

import requests

endpoint = "https://new.fluapi.com/v1/images/generations"
api_key = os.environ["FLU_API_KEY"]

payload = {
    "model": "gpt-image-2",
    "prompt": "一台悬浮在纯白摄影棚中的未来感精密设备,黑色金属材质,青色光线,商业产品摄影",
    "n": 1,
    "size": "2048x2048",
    "quality": "high",
    "output_format": "png",
    "background": "opaque",
}

response = requests.post(
    endpoint,
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=600,
)
response.raise_for_status()

result = response.json()
image_bytes = base64.b64decode(result["data"][0]["b64_json"])
Path("gpt-image-2.png").write_bytes(image_bytes)
import { writeFile } from "node:fs/promises";

const endpoint =
  "https://new.fluapi.com/v1/images/generations";

const response = await fetch(endpoint, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FLU_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt:
      "一台悬浮在纯白摄影棚中的未来感精密设备,黑色金属材质,青色光线,商业产品摄影",
    n: 1,
    size: "2048x2048",
    quality: "high",
    output_format: "png",
    background: "opaque",
  }),
  signal: AbortSignal.timeout(600_000),
});

if (!response.ok) {
  throw new Error(`${response.status}: ${await response.text()}`);
}

const result = await response.json();
const image = Buffer.from(result.data[0].b64_json, "base64");
await writeFile("gpt-image-2.png", image);
02 / REQUEST

请求参数

请求体使用 JSON。推荐显式传入尺寸、质量与输出格式,使生成结果更容易验证和归档。

字段 类型 要求 说明
model string 必填 固定使用 gpt-image-2
prompt string 必填 描述主体、环境、构图、材质、光线、镜头和限制条件。
n integer 可选 生成数量,建议从 1 开始;计费按实际生成张数累加。
size string 可选 输出像素尺寸,例如 2048x20483840x2160
quality string 可选 lowmediumhighauto
output_format string 可选 推荐 png;也可根据上游能力使用 JPEG 或 WebP。
background string 可选 推荐 opaqueauto
03 / RESOLUTION

尺寸规格

以下八种尺寸已通过 Flu API 真实调用验证。横图适合封面与视频背景,竖图适合海报与移动端内容,方图适合商品与社交媒体。

STANDARD

1K

  • 方图1024x1024
  • 横图1536x1024
  • 竖图1024x1536
DETAIL

2K

  • 方图2048x2048
  • 横图2048x1152
  • 竖图1152x2048
ULTRA

4K

  • 横图3840x2160
  • 竖图2160x3840
4K 文件体积明显更大,建议将客户端超时设置为 600 秒,并避免在浏览器前端直接处理超大 Base64 字符串。
04 / RESPONSE

响应处理

成功响应的图像位于 data[0].b64_json。返回体可能不回显请求中的 sizequality,需要从实际图片文件读取像素尺寸。

JSON RESPONSE
{
  "created": 1785302608,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}
Base64 数据会让 JSON 响应体比原始图片更大。生产环境应在服务端完成解码,再上传到对象存储并向业务端返回文件 URL。
05 / BILLING

计费规则

当前 Flu API 对 gpt-image-2 使用按张固定计费。已验证 1K、2K、4K 和不同质量参数的单张扣费一致。

$2.00 每张成功生成的图片

单次请求的预计费用由生成数量决定。尺寸和质量不会改变 Flu API 当前的单张价格。

费用 = n × $2.00 1 张 = $2.00 4 张 = $8.00
计费日志中每张图片记录为 1,000,000 quota,按当前系统换算等于 $2.00
06 / VERIFIED

实测结果

2026 年 7 月 29 日通过 Flu API 正式端点完成验证。矩阵请求全部返回 HTTP 200,实际 PNG 像素与请求尺寸完全一致。

测试项 请求尺寸 实际尺寸 质量 耗时 计费
1K 方图1024x10241024x1024low57 秒$2
1K 横图1536x10241536x1024medium34 秒$2
1K 竖图1024x15361024x1536high47 秒$2
2K 方图2048x20482048x2048high65 秒$2
2K 横图2048x11522048x1152high27 秒$2
2K 竖图1152x20481152x2048high31 秒$2
4K 横图3840x21603840x2160high54 秒$2
4K 竖图2160x38402160x3840high31 秒$2
07 / ERRORS

错误处理

客户端应记录 HTTP 状态码、响应体和请求标识,并对限流、超时及上游临时故障采用有限次数重试。

400
Invalid request
检查模型名称、JSON 格式、尺寸字符串和必填参数。
401
Unauthorized
检查 Authorization 请求头、API Key 是否有效及是否包含 sk- 前缀。
429
Rate limited
降低并发并使用指数退避,避免立即重复提交相同请求。
5xx
Upstream error
保留完整错误体,等待数秒后重试;连续失败时暂停任务并告警。
Timeout
Client timeout
2K 与 4K 生成时间更长,建议请求超时设置为 600 秒。
08 / SECURITY

安全建议

将生图调用封装在自己的后端服务中,统一管理密钥、并发、计费、日志和生成内容存储。

  • 通过环境变量或 Secret Manager 注入 API Key,不在代码中硬编码。
  • 为业务用户设置单次生成数量、并发和每日额度限制。
  • 记录请求时间、模型、尺寸、质量、HTTP 状态和生成文件哈希。
  • 不要将完整 Base64 响应写入普通应用日志,避免日志体积失控。
  • 生成后立即解码并上传对象存储,为业务端返回受控访问 URL。
  • 对 429 和临时 5xx 使用带随机抖动的指数退避,限制最大重试次数。
已复制