图像编辑
兼容 OpenAI Images Edit,根据参考图和指令生成新图片。
POST
https://api.codingrouter.ai/v1/images/edits| 模型 | 令牌分组 | 参考图 |
|---|---|---|
gpt-image-2、gpt-image-2.5 | gpt_image | 1 到 16 张,可加蒙版 |
grok-imagine-image-2.0 | grok | 1 张,每次 $0.004 |
鉴权
Authorization: Bearer <令牌>
请求格式
两种写法任选:
multipart/form-data:上传图片文件。参考图较大时推荐,JSON 里的 base64 会让请求体增大约三分之一。application/json:用 URL 或data:base64 传图片。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 见上表 |
prompt | string | 是 | 编辑指令,最长 32000 字符 |
image | file | 是 | 表单上传:单张用 image,多张用多个 image[] |
images | array | 是 | JSON 写法(GPT Image):[{"image_url": "https://... 或 data:..."}] |
image | string | 是 | JSON 写法(Grok):data: 开头的 base64 |
mask | file | 否 | GPT Image 蒙版:PNG,尺寸与第一张参考图相同,透明区域是要重绘的部分 |
size | string | 否 | 同 图像生成 |
quality | string | 否 | 同图像生成 |
n | integer | 否 | GPT Image 生成张数,1 到 10 |
output_format、output_compression、background、moderation | 否 | 同图像生成 | |
input_fidelity | string | 否 | 仅 gpt-image-2.5 |
stream | boolean | 否 | 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.pngbash
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.pngbash
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 | 上游生成失败,可重试 |
