AI 生图使用教程（gpt-image-2）

配置步骤

1. 1

   准备 API Key 和额度

   生图使用与编程工具相同的密钥和同一份额度，不需要单独开通权限。

   1. 登录控制台，进入「API 密钥」页，复制一把 sk- 开头的完整密钥（例如默认的 CoderPlan-Auto）。还没有账号或密钥时，先看快速上手教程。
   2. 在控制台确认 API 使用额度大于零；生图按量从同一份额度里扣费。
   3. 不要把完整密钥发到公开聊天、截图或 issue 里。

   查看 API Key 接入配置
2. 2

   选择使用方式：图形客户端或 API

   两种方式用的是同一个地址、同一把密钥、同一组模型名，按你的使用习惯选即可。

   1. 只想输入文字就出图：用带「绘画」功能的桌面客户端，推荐 Cherry Studio，按第 3-5 步配置。
   2. 会写代码或想批量出图：直接调用图像生成接口，看第 6 步。
3. 3

   安装 Cherry Studio

   Cherry Studio 是免费的桌面 AI 客户端，支持 Windows 和 macOS，自带绘画功能，可以接入任何 OpenAI 兼容的图像接口。

   下载并安装

   打开官网，下载对应系统的版本安装，首次打开按引导完成初始化。

   打开 Cherry Studio 官网下载
4. 4

   在 Cherry Studio 里添加 CoderPlan

   把 CoderPlan 配置为一个 OpenAI 兼容服务商，再手动添加生图模型。

   1. 打开设置（左下角齿轮图标）→ 模型服务 → 添加服务商，类型选 OpenAI，名称填 CoderPlan。
   2. API 地址填 https://api.coderplan.ai（填根地址即可，客户端会自动补全请求路径）。
   3. API 密钥粘贴第 1 步复制的 sk- 完整密钥，保存。
   4. 在该服务商的模型管理里手动添加模型：模型 ID 填 gpt-image-2。需要高清输出再加 gpt-image-2-2k 和 gpt-image-2-4k。
5. 5

   生成第一张图

   用绘画功能出图，而不是在聊天窗口里选生图模型。

   1. 回到主界面，左侧进入「绘画」功能，服务商选 CoderPlan，模型选 gpt-image-2。
   2. 在提示词里具体描述画面：主体、风格、构图、光线写得越具体，结果越接近预期。点击生成，通常十几秒到一分钟出图。
   3. 对结果不满意时，修改提示词重新生成即可；生图有随机性，同一提示词多次生成的结果也会不同。
6. 6

   方式二：直接调用 API

   任何能发 HTTP 请求的环境都可以出图。接口与 OpenAI 图像生成接口格式一致。

   接口要点

   自己封装调用时注意以下几点，可以避开绝大多数报错。

   1. 请求地址为 POST https://api.coderplan.ai/v1/images/generations，Authorization 头携带 Bearer 密钥。
   2. model 填 gpt-image-2、gpt-image-2-2k 或 gpt-image-2-4k；prompt 为画面描述；size 常用 1024x1024。
   3. 生图模型只支持图像生成接口，不能通过 chat/completions 调用。
   4. 返回的 JSON 中包含生成结果；批量出图可增大 n，但建议先单张验证提示词效果。

   复制

   curl https://api.coderplan.ai/v1/images/generations \  -H "Authorization: Bearer sk-你的完整密钥" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-2",    "prompt": "一只戴毛线帽的橘猫，扁平插画风格，暖色调",    "size": "1024x1024",    "n": 1  }'

7. 7

   确认出图与扣费

   生成成功才会扣费，每笔明细都可以核对。

   1. 客户端出图后图片直接显示在界面里；接口调用则从返回的 JSON 中取图。
   2. 在控制台「日志」页可以看到每次生成的扣费明细。
   3. 想控制成本：先用 gpt-image-2 标准版确认构图和风格，满意后再用 2k/4k 高清版出成品。