Api referenceImages
图像编辑
使用 GPT Image 2 根据参考图像生成或编辑图像。
使用 gpt-image-2 和参考图片生成新图片。请求必须使用 multipart/form-data 上传图片文件。
警告
使用 curl -F 或 SDK 的 multipart 功能时，不要手动设置 Content-Type。客户端需要自动生成包含 boundary 的请求头。
请求示例
curl --request POST \
--url https://tokenflash.cn/v1/images/edits \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'model=gpt-image-2' \
--form 'prompt=保留主体，将画面转换为清新的水彩插画' \
--form 'image=@./reference.jpg' \
--form 'n=1' \
--form 'size=1024x1024'import requests
with open("reference.jpg", "rb") as image:
response = requests.post(
"https://tokenflash.cn/v1/images/edits",
headers={"Authorization": "Bearer YOUR_API_KEY"},
data={
"model": "gpt-image-2",
"prompt": "保留主体，将画面转换为清新的水彩插画",
"n": "1",
"size": "1024x1024",
},
files={"image": ("reference.jpg", image, "image/jpeg")},
timeout=300,
)
response.raise_for_status()
print(response.json())const form = new FormData();
form.append('model', 'gpt-image-2');
form.append('prompt', '保留主体，将画面转换为清新的水彩插画');
form.append('image', imageFile);
form.append('n', '1');
form.append('size', '1024x1024');
const response = await fetch('https://tokenflash.cn/v1/images/edits', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY' },
body: form,
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());请求参数
string required
Bearer API Key，例如 Bearer sk-xxxxxxxx。
string required
固定填写 gpt-image-2。
string required
描述希望如何参考或修改上传的图片，并说明哪些内容需要保留。
file required
参考图片文件。推荐使用 JPEG 或 PNG。
file
可选蒙版图片，用于局部重绘。建议与参考图片尺寸一致。
integer
生成图片数量。建议使用 1。
string
输出尺寸，例如 1024x1024。实际支持的尺寸取决于当前渠道。
string
图片质量，例如 auto、standard、high。该参数可能因渠道不同而被忽略。
string
输入图片保真度，可传 low 或 high。是否生效取决于当前渠道。
string
期望的返回格式，可传 url 或 b64_json。客户端应同时兼容两种实际返回形式。
成功响应
响应结构与图像生成接口一致。
{
"created": 1784039688,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
]
}{
"error": {
"message": "image is required",
"type": "invalid_request_error"
}
}说明
图片生成通常需要几十秒到数分钟。建议将客户端请求超时时间设置为至少 300 秒。