Skip to main content

接口说明

端点: POST https://geekapis.com/v1/images/generations 图像编辑模式与文生图使用相同端点——只需在请求中加入 image_urls 字段,系统即自动切换为编辑模式。支持以下三种典型用法:
  • 图生图(多参考图融合):提供 1–4 张参考图 + prompt,生成融合多图风格或内容的新图
  • 局部重绘(inpainting):额外提供 mask_url,精确控制图像中需重新绘制的区域
  • 风格迁移:以参考图为样本,配合详细 prompt 生成指定风格的高清图像
接口采用同步任务模式
编辑模式与生成模式完全兼容,无需切换端点。在标准生成请求基础上加入 image_urls(以及可选的 mask_url)即可启用编辑模式。

请求参数

认证

所有请求须在 Header 中携带 Bearer Token:
前往 API Key 管理页面 获取您的密钥。

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