TokenFlow 使用文档

简体中文

English

简体中文

English

Appearance

TokenFlow2026-07-05
1911
7.5m

GPT-Image-2 绘图教程 ​

前置准备 ​

gpt-image-2 属于 生成图片 分组。调用前，请先创建一个分组为 生成图片 的令牌。

创建方法参见 创建 API 令牌，在“令牌分组”里选择 生成图片 即可。

分组一定要选对

如果令牌分组不是 生成图片，调用 gpt-image-2 会提示模型不存在或无权限。

调用方式 ​

OpenAI 把图片能力分成三类接口：Images API、Responses API、Chat Completions API。TokenFlow 的 gpt-image-2 只支持 Images API，出图请优先用它。

方式一：Images API（推荐） ​

Images API 下有两个接口：

  • 文生图：POST https://tokenflow.run/v1/images/generations
  • 图片编辑 / 图生图：POST https://tokenflow.run/v1/images/edits

新手只需先照示例传 model、prompt，并把 n 设为 1；需要改图时再用 image 字段上传参考图。

文生图：/v1/images/generations ​

请求示例

bash
curl --location 'https://tokenflow.run/v1/images/generations' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer 你的生成图片分组令牌' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫戴着橙色围巾抱着水獭，温暖插画风格",
    "size": "3840x2160",
    "quality": "high",
    "output_format": "png",
    "response_format": "url",
    "n": 1
  }'

常用参数

参数说明
model固定填 gpt-image-2
prompt图片描述提示词，必填
n生成数量，建议固定为 1（多张请自行循环请求）
size输出尺寸，如 1024x1024、1536x1024、3840x2160，或 auto
quality画质：low / medium / high / auto
output_format输出格式：png / jpeg / webp
output_compression压缩率 0–100，仅对 jpeg/webp 生效
background背景：opaque（不透明）/ transparent（透明）
response_format返回形式：url（默认）或 b64_json

图片编辑 / 图生图：/v1/images/edits ​

该接口用 multipart/form-data 上传图片。image 是二进制图片文件，prompt 写清楚希望怎么改。

请求示例

bash
curl --location 'https://tokenflow.run/v1/images/edits' \
  --header 'Authorization: Bearer 你的生成图片分组令牌' \
  --form 'model="gpt-image-2"' \
  --form 'prompt="保留图片主体，在右上角加一枚红色小印章，印章上写 DEMO"' \
  --form 'image=@"/path/to/your-image.jpg"' \
  --form 'size="1024x1024"' \
  --form 'quality="high"' \
  --form 'output_format="png"' \
  --form 'response_format="url"'

常用参数

在文生图参数的基础上，图片编辑还支持：

参数说明
image要编辑的原图（二进制文件），必填
mask可选，局部修改用的蒙版。建议用 PNG，透明区域表示允许模型重点修改的位置
input_fidelity设为 high 可让编辑结果更贴近原图

不传 mask 时，模型会按提示词对整张图进行编辑。

尺寸与质量 ​

常用尺寸

  • 1024x1024：正方形
  • 1536x1024：横向
  • 1024x1536：纵向
  • 2048x2048：2K 正方形
  • 2048x1152：2K 横向
  • 3840x2160：4K 横向
  • 2160x3840：4K 纵向
  • auto：自动（默认）

尺寸限制

  • 最大边长 ≤ 3840 像素
  • 宽和高都必须是 16 的倍数
  • 长边与短边的比例不超过 3:1
  • 总像素数不少于 655,360，且不超过 8,294,400

画质选项

low（低）/ medium（中）/ high（高）/ auto（自动，默认）

参数怎么选 ​

  • 最简单文生图：只传 model、prompt，n 设为 1。
  • 想更清晰：加 quality: "high"。
  • 想控制尺寸：加 size，如 1024x1024 或 1536x1024。
  • 想拿图片链接：使用默认 response_format: "url"。
  • 想让程序自己保存：使用 response_format: "b64_json"。
  • 不要把 n 设为大于 1，多张图请自行循环请求。

返回结果 ​

默认返回图片下载地址：

json
{
  "created": 1776923999,
  "data": [
    {
      "url": "https://tokenflow.run/file_download/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "revised_prompt": "..."
    }
  ]
}

url 即生成图片的地址，直接访问即可下载。revised_prompt 是模型实际使用前改写过的提示词，出现它是正常的，不是报错。

若请求里传了 "response_format": "b64_json"，返回的是 Base64 图片数据：

json
{
  "created": 1776923999,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": "..."
    }
  ]
}

此时通常没有 url，需要客户端自己把 b64_json 解码成图片文件。普通用户更推荐默认的 url，最方便保存和分享。

方式二：Responses API（不支持） ​

不支持

gpt-image-2 不支持 通过 /v1/responses 出图。请勿使用 image_generation 工具或 input / input_image 来调用它生成图片。

需要文生图请用 /v1/images/generations，需要上传图片编辑请用 /v1/images/edits。

方式三：Chat Completions API（不支持） ​

不支持

gpt-image-2 不支持 通过 /v1/chat/completions 出图。请勿把 messages、image_url、size、quality、output_format 等参数放到 Chat Completions 里调用图片生成。

如果你的客户端只支持 Chat Completions 又必须接图片能力，建议改为支持 OpenAI Images API，不要把 /v1/chat/completions 当成 /v1/images/generations 的替代品。

在 Cherry Studio 中使用 ​

  1. 参照 创建 API 令牌，创建分组为 生成图片 的令牌，复制 API Key。
  2. 到 Cherry Studio 官网下载并安装。
  3. 打开后点左下角设置，进入 模型服务 页面，点底部 添加 新增提供商。
  4. 在添加窗口填写提供商名称（如 tokenflow-gpt-image-2），提供商类型 选 New API，点 确定。
  5. 在左侧找到刚添加的提供商，把 生成图片 分组的 API Key 填入 API 密钥，API 地址 填 https://tokenflow.run。
  6. 点模型区域右侧 获取模型列表，刷新后添加 gpt-image-2 模型。
  7. 点 gpt-image-2 右侧编辑按钮，把 端点类型 设为 图像生成（OpenAI），保存。
  8. 回到首页，点顶部 +，在应用列表中选 绘画。
  9. 进入绘画页面，左侧 提供商 选刚添加的供应商，模型 选 gpt-image-2。首次使用建议把 图片尺寸、质量、敏感度 保持为 自动，生成数量 保持为 1。
  10. 只按提示词出图，顶部选 绘图 模式，输入提示词后发送。
  11. 需要上传参考图做图生图或局部修改，顶部切到 编辑 模式，在左侧 输入图片 上传参考图，再输入修改要求后发送。

使用建议

  • API 地址 直接填 https://tokenflow.run 即可，Cherry Studio 会自动拼接兼容端点，无需手动补 /v1。
  • 模型列表里没有 gpt-image-2 时，先在 管理 中刷新；仍无法绘图请检查 端点类型 是否为 图像生成（OpenAI）。
  • 在普通对话页直接调用 gpt-image-2 时，建议关闭 流式输出，避免返回内容解析异常；使用 绘画 应用通常不需要额外处理。

可能出现的问题 ​

  • 弹出 Failed to fetch：通常是连接被中断，多与本机代理或网络环境有关。先检查代理，确认 Cherry Studio 能正常访问 https://tokenflow.run 后再重试。
  • 弹出 Unexpected token '<', "<html><h"... is not valid JSON：一般是请求过程中收到了 Cloudflare 等页面内容，客户端按 JSON 解析时报错。直接重试或稍后再生成即可。

特别注意：长连接与代理设置 ​

无论是直接调 API 还是在 Cherry Studio 等客户端里使用 gpt-image-2，图片生成通常比普通聊天耗时更久，尤其是编辑模式、高画质或高分辨率时。如果本机代理、网络工具或中间网关对长连接有限制，可能会在 60 秒左右主动断开，表现为请求超时、无返回，或客户端提示 Failed to fetch。

如果确认是代理导致连接中断，建议把本站域名 tokenflow.run 加入代理工具的直连或白名单规则，让访问 API 时不经过代理。不同软件设置入口不同，核心是添加类似 domain:tokenflow.run 的域名规则。

放行后，同类请求可以等待更久并正常返回。为减少不可控的网络中断，建议绘图请求尽量直连 tokenflow.run，不要经过会限制长连接的代理或中转网络。

最近更新