Skip to content

图像编辑 ​

兼容 OpenAI Images Edit,根据参考图和指令生成新图片。

POSThttps://api.codingrouter.ai/v1/images/edits
模型令牌分组参考图
gpt-image-2、gpt-image-2.5gpt_image1 到 16 张,可加蒙版
grok-imagine-image-2.0grok1 张,每次 $0.004

鉴权 ​

Authorization: Bearer <令牌>

请求格式 ​

两种写法任选:

  • multipart/form-data:上传图片文件。参考图较大时推荐,JSON 里的 base64 会让请求体增大约三分之一。
  • application/json:用 URL 或 data: base64 传图片。

请求参数 ​

参数类型必填说明
modelstring是见上表
promptstring是编辑指令,最长 32000 字符
imagefile是表单上传:单张用 image,多张用多个 image[]
imagesarray是JSON 写法(GPT Image):[{"image_url": "https://... 或 data:..."}]
imagestring是JSON 写法(Grok):data: 开头的 base64
maskfile否GPT Image 蒙版:PNG,尺寸与第一张参考图相同,透明区域是要重绘的部分
sizestring否同 图像生成
qualitystring否同图像生成
ninteger否GPT Image 生成张数,1 到 10
output_format、output_compression、background、moderation否同图像生成
input_fidelitystring否仅 gpt-image-2.5
streamboolean否GPT Image:true 时以 SSE 返回,结果在 image_edit.completed 事件里

参考图要求:PNG、JPEG 或 WebP,单张不超过 50 MB;JSON 里的图片 URL 必须公网可访问,服务端会在 60 秒内下载。

请求示例 ​

bash
curl https://api.codingrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -F model=gpt-image-2 \
  -F prompt="把背景换成海边日落,人物保持不变" \
  -F size=1024x1536 \
  -F quality=medium \
  -F image=@src.png
bash
curl https://api.codingrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -F model=gpt-image-2.5 \
  -F prompt="把第二张图里的帽子戴到第一张图的人物头上" \
  -F "image[]=@person.png" \
  -F "image[]=@hat.png" \
  -F mask=@mask.png
bash
curl https://api.codingrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "把背景换成海边日落,人物保持不变",
    "size": "1024x1024",
    "quality": "low",
    "images": [
      {"image_url": "https://example.com/src.png"},
      {"image_url": "data:image/jpeg;base64,<图片 base64>"}
    ]
  }'
python
import base64
from openai import OpenAI

client = OpenAI(base_url="https://api.codingrouter.ai/v1", api_key="sk-你的令牌", timeout=300)

result = client.images.edit(
    model="gpt-image-2",
    prompt="把背景换成海边日落,人物保持不变",
    image=[open("src.png", "rb")],   # 多张参考图就放多个文件
    size="1024x1536",
    quality="medium",
)
with open("out.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))
js
import fs from "node:fs";
import OpenAI, { toFile } from "openai";

const client = new OpenAI({
  baseURL: "https://api.codingrouter.ai/v1",
  apiKey: process.env.CODINGROUTER_KEY,
  timeout: 300_000,
});

const result = await client.images.edit({
  model: "gpt-image-2",
  prompt: "把背景换成海边日落,人物保持不变",
  image: await toFile(fs.createReadStream("src.png"), "src.png", { type: "image/png" }),
  size: "1024x1536",
  quality: "medium",
});
fs.writeFileSync("out.png", Buffer.from(result.data[0].b64_json, "base64"));

Grok Imagine ​

bash
# 表单
curl https://api.codingrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -F model=grok-imagine-image-2.0 \
  -F prompt="把苹果换成青苹果,其余保持不变" \
  -F image=@src.jpg

# JSON
curl https://api.codingrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-image-2.0", "prompt": "把苹果换成青苹果,其余保持不变", "image": "data:image/jpeg;base64,<原图 base64>"}'

响应示例 ​

与 图像生成 相同:

json
{
  "created": 1794383305,
  "data": [{"b64_json": "<base64 图片数据>"}],
  "output_format": "png",
  "size": "1024x1536",
  "usage": {"input_tokens": 211, "output_tokens": 1372, "total_tokens": 1583}
}

错误 ​

状态码常见原因
400尺寸不符合规则、quality 不支持、图片格式不对或超过大小、蒙版尺寸与原图不一致、图片 URL 下载失败、response_format 为 url
413请求超过 256 MB
429并发已满,稍后重试
502上游生成失败,可重试