GPT Image 2 API，每张图片一个固定价格

1. 创建密钥

   注册，充值 $5 起，然后在 API 密钥页面创建一个密钥。图像模型由 gpt-value 渠道组提供，因此请使用选择了 自动 或绑定到该组的密钥。

2. 把 OpenAI SDK 指向 Lovely Router

   把 base URL 设为 https://lovelyrouter.com/v1。请求按 OpenAI 的定义原样透传，因此官方 SDK 无需修改即可使用。

3. 生成图像

   POST /v1/images/generations 会保持连接直到图像生成完毕，并以 base64 形式在 b64_json 中返回。

   cURLPythonNode.js

   Shell

   curl https://lovelyrouter.com/v1/images/generations \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "model": "gpt-image-2",
       "prompt": "A watercolor painting of a red fox in a snowy birch forest at dawn",
       "size": "1024x1024",
       "quality": "medium"
     }' | jq -r '.data[0].b64_json' | base64 --decode > fox.png

生成一张图像通常需要 40 秒到 2 分钟，另加在队列中等待的时间。网关会在九分钟内给出响应，所以请把 HTTP 客户端的超时设为至少十分钟。response_format: "url" 会被忽略，图像始终以 base64 返回。

编辑图像或给模型参考图（产品、Logo、人物、风格）时，用任意一个模型把最多 16 张图片（可选附带一个 mask）发送到 POST /v1/images/edits：以 multipart/form-data 文件形式，或在 JSON 中给出 URL。编辑与生成价格相同。

curl https://lovelyrouter.com/v1/images/edits \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F model=gpt-image-2 \
  -F image=@fox.png \
  -F prompt="Make it night with a full moon" | jq -r '.data[0].b64_json' | base64 --decode > fox-night.png

每个图像请求都会进入队列，一有空闲容量就开始生成，因此突发的大量请求会排队等候，而不是直接失败。每个账户最多可以同时有 20 张图像在排队或生成中。如果你不想让一个连接保持好几分钟，可以使用图像任务：

# 提交：返回 202，带有任务 id 及其 queue_position
curl https://lovelyrouter.com/v1/images/jobs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "gpt-image-2", "prompt": "A red fox in a snowy birch forest", "size": "1536x1024"}'

# 最多等待 60 秒，然后下载文件
curl "https://lovelyrouter.com/v1/images/jobs/img_8c1f0e2a9b7d4f3e6a5c2b1d?wait=60" \
  -H "Authorization: Bearer $LOVELY_API_KEY"
curl -o fox.png https://lovelyrouter.com/v1/images/jobs/img_8c1f0e2a9b7d4f3e6a5c2b1d/content \
  -H "Authorization: Bearer $LOVELY_API_KEY"

任务接受与生成请求相同的字段；带有输入图片，它就成为一个编辑任务。已完成任务的图像保留 7 天。你可以列出最近的任务，也可以取消仍在排队的任务。如果同步请求九分钟后仍未完成，会返回 504，并在 x-lovely-image-job 响应头中带上任务 id，图像会继续生成，你可以像取回任务一样取回它。

想不写代码就试试提示词和编辑效果，把在线体验切换到 图像 模式即可。它基于图像任务运行。

智能体同样可以生成图像。MCP 服务器提供 generate_image 工具，使用 GPT Image 2.5（2.5 不可用时改用 GPT Image 2），每张价格相同，也可以通过 URL 传入参考图。它返回一个 24 小时内无需密钥即可下载的链接，以及一条保存文件的 curl 命令；get_image 用于等待尚未完成的图像。把服务器添加到 Claude Code：

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

然后提问：“生成一张 1536x1024 的首页主视觉图，扁平插画风格，画面是黄昏时的灯塔，保存到 public/hero.png。”

每张图片固定 $0.04，生成和编辑都一样，任何尺寸和质量同价。响应中的 usage 对象仅供参考，不影响价格。

提交图像时，会先从你的余额中预留它的价格，图像完成后再结算。请求被拒绝、任务被取消或没有产出图像时，都不收费。图像一旦生成就会收费，即使你的客户端在收到之前就断开了连接。没有订阅；同一余额可以购买的其他产品，请参阅价格页。