GPT-Image-2 绘图教程

前置准备

gpt-image-2 模型属于 Sora 分组，使用前需要创建令牌分组为 sora 的令牌。

参照创建令牌分组教程创建令牌，分组选择 sora。

调用方式

OpenAI 官方文档把图片相关能力分成 Responses API、Images API、Chat Completions API 三类。对 Packy 的 gpt-image-2 来说，出图请优先使用 Images API。

API	OpenAI 官方用途	Packy gpt-image-2 使用建议
Responses API	分析图片，把图片作为输入；可通过工具生成图片输出	不支持作为 gpt-image-2 的出图入口
Images API	生成图片，可上传图片作为输入进行编辑	推荐，文生图和图片编辑均支持
Chat Completions API	分析图片输入，生成文本或音频	不支持作为 gpt-image-2 的出图入口

方式一：Images API（推荐）

Images API 是 gpt-image-2 的推荐出图方式，分为文生图和图片编辑两个接口：

• 文生图：POST https://www.packyapi.com/v1/images/generations
• 图片编辑 / 图生图：POST https://www.packyapi.com/v1/images/edits

文生图：/v1/images/generations

接口实例：

curl --location 'https://www.packyapi.com/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ***' \
--header 'Accept: */*' \
--data '{
  "model": "gpt-image-2",
  "prompt": "一只橘猫戴着橙色围巾抱着水獭，温暖插画风格",
  "size": "3840x2160",
  "quality": "high",
  "output_format": "png",
  "response_format": "url",
  "n": 1
}'

文生图参数：

参数	类型	支持情况	说明
model	string	支持	固定填写 gpt-image-2
prompt	string	支持	图片描述提示词
n	integer	仅支持 1	只支持一次返回 1 张图
size	string	支持	支持 auto 和符合限制的尺寸
quality	string	支持	low/medium/high/auto
response_format	string	支持	url/b64_json
output_format	string	部分支持	推荐 png 或 jpeg
output_compression	integer	支持	仅 output_format 为 jpeg 时使用
background	string	部分支持	建议 opaque
moderation	string	支持	auto/low
user	string	支持	可选
stream	boolean	不支持	不要开启
partial_images	integer	不支持	-
style	string	不建议	gpt-image-2 不需要传

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

接口实例：

curl --location 'https://www.packyapi.com/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"'

返回结果

默认返回图片下载地址：

{
  "created": 1776923999,
  "data": [
    {
      "url": "https://external-resources.packyapi.com/file_download/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "revised_prompt": "..."
    }
  ]
}

如果请求里传了 "response_format": "b64_json"，返回内容会变成 Base64 图片数据：

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

方式二：Responses API（不支持）

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

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

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

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

如果使用 Cherry Studio，请切换到"绘画"应用，并确保端点类型是 图像生成（OpenAI）。

在 Cherry Studio 中使用

1. 参照创建令牌分组教程，创建令牌分组为 sora 的令牌。
2. 访问 Cherry Studio 官网下载并安装软件。
3. 打开 Cherry Studio，点击左下角设置按钮，进入 模型服务 页面，点击底部的 添加 按钮新增提供商。
4. 在添加提供商窗口中填写提供商名称（例如 packyapi-gpt-image-2），提供商类型选择 New API，然后点击 确定。
5. 在左侧列表中找到刚添加的提供商，将第 1 步复制的 sora 分组 API Key 填入 API 密钥，API 地址 填写 https://www.packyapi.com。
6. 点击模型区域右侧的 获取模型列表，刷新后添加 gpt-image-2 模型。
7. 点击 gpt-image-2 右侧的编辑按钮，进入编辑模型窗口，将 端点类型 设置为 图像生成（OpenAI），然后点击 保存。
8. 回到首页，点击顶部的 + 按钮，在应用列表中选择 绘画。
9. 进入绘画页面后，左侧 提供商 选择刚才添加的供应商，模型 选择 gpt-image-2。

使用建议

• API 地址直接填写 https://www.packyapi.com 即可，Cherry Studio 会自动拼接兼容端点。
• 使用 绘图 模式可以进行文生图；使用 编辑 模式可以上传参考图进行图生图或局部修改。
• 如果你在普通对话页中直接调用 gpt-image-2，建议关闭 流式输出。

可能出现的问题

• 如果 Cherry Studio 弹出 Failed to fetch，通常是请求连接被中断，可能与本机代理或网络环境有关。
• 如果 Cherry Studio 弹出 Unexpected token '<'，通常是请求过程中收到了 Cloudflare 等页面内容。

长连接与代理设置

图片生成请求通常比普通聊天请求耗时更久。如果本机代理对长连接有限制，可能会在 60 秒左右主动断开连接。

建议将本站域名 packyapi.com 加入代理工具的直连或白名单规则，让访问 Packy API 时不再经过代理。