IMAGE API

GPT-Image-2 图像生成

GPT-Image-2 文生图、图生图、分辨率和调用示例。

GPT-Image-2 图像生成

RootFlow AI 支持基于 GPT-Image-2 的 AI 图像生成，兼容 OpenAI Images API 协议，支持文生图和图生图。

功能特性

兼容 OpenAI /v1/images/generations 协议，现有 SDK 无缝接入
支持文生图（text-to-image）和图生图（image-to-image）
三档分辨率：1K / 2K / 4K
13 种画面比例可选
按次计费，失败不扣费

可用模型与定价

创建令牌时，分组请选择 GPT绘图计次。下列价格为 SVIP 用户分组参考价格。

| 模型名 | 分辨率 | 默认质量 | 价格 | 说明 | |--------|--------|---------|------|------| | gpt-image-2-count | 1K | high | ¥0.10 / 次 | 标准分辨率，所有比例可用 | | gpt-image-2-hd-count | 2K | high | ¥0.25 / 次 | 高清分辨率，所有比例可用 | | gpt-image-2-4k-count | 4K | high | ¥0.50 / 次 | 超清分辨率，仅支持 6 种宽幅比例 |

在控制台创建令牌时，分组必须选择「GPT绘图计次」，否则无法调用图像生成模型。

质量控制

通过 quality 参数可以控制生成质量，支持三档：

| 质量档位 | 说明 | 生成速度 | 适用场景 | |---------|------|---------|---------| | low | 低质量，细节较少 | 快（30-60s） | 快速预览、草图 | | medium | 中等质量，平衡速度与效果 | 中（40-80s） | 日常使用 | | high | 高质量，细节丰富（默认） | 慢（50-120s） | 最终成品、高要求场景 |

示例：

# 快速预览（低质量）
curl https://api.rootflowai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2-count",
    "prompt": "一只橘猫坐在窗台上看夕阳",
    "quality": "low",
    "size": "1024x1024"
  }'

# 最终成品（高质量，默认）
curl https://api.rootflowai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2-4k-count",
    "prompt": "赛博朋克风格的未来城市夜景，超精细细节",
    "quality": "high",
    "size": "2880x1680"
  }'

不同质量档位价格相同，仅影响生成速度和画面细节。建议先用 low 快速验证构图，确认后再用 high 生成最终版本。

支持的 size

支持标准 OpenAI 像素格式和比例格式，系统会自动转换：

| 像素格式 | 等效比例 | 类型 | |----------|---------|------| | 1024x1024 | 1:1 | 正方 | | 1536x1024 | 3:2 | 横图 | | 1024x1536 | 2:3 | 竖图 | | 1792x1024 | 16:9 | 横图 | | 1024x1792 | 9:16 | 竖图 |

也可以直接传比例格式：1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21

4K 分辨率仅支持 16:9、9:16、2:1、1:2、21:9、9:21 六种宽幅比例。

快速开始

文生图

curl https://api.rootflowai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2-count",
    "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
    "n": 1,
    "size": "1024x1024"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxx",
    base_url="https://api.rootflowai.com/v1"
)

response = client.images.generate(
    model="gpt-image-2-count",
    prompt="一只橘猫坐在窗台上看夕阳，水彩画风格",
    n=1,
    size="1024x1024",
    quality="high"  # 可选：low / medium / high（默认）
)

print(response.data[0].url)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxxxxxxxxxx",
  baseURL: "https://api.rootflowai.com/v1",
});

const response = await client.images.generate({
  model: "gpt-image-2-count",
  prompt: "一只橘猫坐在窗台上看夕阳，水彩画风格",
  n: 1,
  size: "1024x1024",
  quality: "high", // 可选：low / medium / high（默认）
});

console.log(response.data[0].url);

高清文生图（2K）

使用 gpt-image-2-hd-count 模型获得 2K 分辨率输出：

curl https://api.rootflowai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2-hd-count",
    "prompt": "赛博朋克风格的未来城市夜景，霓虹灯倒映在雨水中",
    "n": 1,
    "size": "1792x1024"
  }'

图生图

通过 image 字段传入参考图 URL，基于参考图进行风格转换或内容修改：

curl https://api.rootflowai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2-count",
    "prompt": "把这张照片转换成油画风格",
    "n": 1,
    "size": "1024x1024",
    "image": ["https://example.com/photo.png"]
  }'

image 字段接受 URL 数组，最多 16 张参考图
支持 HTTPS URL 和 base64 data URI 混填
不传 size 时输出分辨率跟随输入图；传 size 则按指定尺寸出图

响应格式

标准 OpenAI Images 响应格式：

{
  "created": 1777026453,
  "data": [
    {
      "url": "https://img.rootflowai.com/f/image/xxx.png"
    }
  ]
}

返回的图片 URL 有效期约 24 小时，建议及时下载或转存。

AI 编程工具集成

我们提供了开源的图像生成 Skill 工具包，可以集成到 Claude Code、Codex、Cherry Studio 等 AI 编程工具中，让 AI 助手直接帮你生成和编辑图片。

GitHub 仓库：RyanWeb31110/rootflowai-image

支持的平台：

| 平台 | 安装方式 | |------|---------| | Claude Code | 下载 claude-compatible 包，放入 .claude/skills/ | | Codex (Skill) | 下载 codex-skill 包，放入 skills 目录 | | Codex (Plugin) | 下载 codex-plugin 包，放入 .codex-plugins/ | | Cherry Studio | 下载 cherry-studio 包，按平台说明安装 |

安装后，AI 助手可以通过自然语言指令帮你生图：

帮我生成一张 16:9 的赛博朋克城市海报，2K 分辨率

把这张照片转换成水彩画风格

详细安装和使用说明请参考 GitHub 仓库 README。

注意事项

1. n 参数目前固定为 1，不支持单次生成多张 2. 建议不要在 prompt 中重复描述比例，通过 size 字段控制即可 3. 生成时间：

1K/2K 分辨率：通常 30~90 秒

4K 分辨率：通常 50~150 秒

quality=low 可缩短 20-30% 生成时间

请设置足够的超时时间（建议 300 秒以上，4K 建议 600 秒）

4. 内容会经过安全审核，违规内容会被拒绝且不计费 5. 失败请求不扣费