接口说明
端点:POST https://geekapis.com/v1/images/generations
图像编辑模式与文生图使用相同端点——只需在请求中加入 image_urls 字段,系统即自动切换为编辑模式。支持以下三种典型用法:
- 图生图(多参考图融合):提供 1–4 张参考图 +
prompt,生成融合多图风格或内容的新图 - 局部重绘(inpainting):额外提供
mask_url,精确控制图像中需重新绘制的区域 - 风格迁移:以参考图为样本,配合详细
prompt生成指定风格的高清图像
编辑模式与生成模式完全兼容,无需切换端点。在标准生成请求基础上加入
image_urls(以及可选的 mask_url)即可启用编辑模式。请求参数
认证
所有请求须在 Header 中携带 Bearer Token:Body 参数
string
required
图像生成模型名称。固定填写
gpt-image-2。string
required
描述期望的编辑效果。示例:
"把背景换成星空,保持主体人物不变" 或 "将两张参考图融合成赛博朋克风格插画海报"string[]
required
参考图 URL 数组(触发编辑模式的关键字段)。
- 最多 4 张
- 支持 PNG / JPG 格式,单张 ≤ 2MB
string
遮罩图 URL,用于局部重绘(inpainting)。
- 须为 PNG 格式,且包含 Alpha 通道
- 透明区域(alpha = 0) 为待重绘区域;不透明区域 保持原图内容不变
- 尺寸须与
image_urls中第一张参考图完全一致
string
输出图像宽高比。默认值:
"1024x1024",也可传 "auto":1K :1:1=1024x1024, 9:16=720x1280, 16:9=1280x720, 3:2=1248x832,2K:1:1=2048x2048, 9:16=1440x2560, 16:9=2560x1440, 3:2=2496x1664, 4:3=2304x1728, 3:4=1728x2304, 2:3=1664x2496,4K:9:16=2160x3840, 16:9=3840x2160,string
图片质量。默认值:
"high"。low— 快速省成本,适合草稿预览medium— 平衡速度与质量high— 最高精度(默认)
string
输出文件格式。默认值:
"png"。支持 "png" / "jpeg"。注意:不支持 "webp" 格式(Azure OpenAI 后端限制)。遮罩图格式要求:
mask_url 指向的图片必须是含 Alpha 通道的 PNG 文件。透明像素(alpha = 0)标记为重绘区域,不透明像素标记为保留区域。遮罩尺寸必须与第一张参考图的原始尺寸完全匹配。代码示例
响应示例
200 OK
