Skip to main content
使用 OpenAI 兼容接口(/v1/images/generations 和 /v1/images/edits)调用 Gemini 图像生成模型,提供文生图和参考图编辑两个同步接口。兼容 OpenAI SDK,迁移成本低。

支持的模型

认证方式

文生图 /v1/images/generations

方法:POST Base URL:https://api.gregapi.com/v1/images/generations

请求参数

宽高比枚举:
gemini-3.1-flash-image 额外支持 1:4、4:1、1:8、8:1、9:21。

请求示例

响应结构(response_format=b64_json)

响应结构(response_format=url)

封控但已计费的错误响应

仅当本次失败已产生可计费 prompt/input tokens 时才会返回 usage;参数校验失败、额度不足、网络失败或上游未返回 usage 的普通失败不会返回 usage。

参考图编辑 /v1/images/edits

方法:POST(multipart/form-data) Base URL:https://api.gregapi.com/v1/images/edits

请求参数

说明

  • image_urls[] 第一个 URL 作为基准图,其余作为参考图;总计最多 14 张。
  • 仅支持公网 HTTP/HTTPS 图片 URL,不支持 localhost 和内网 IP。
  • 未指定 size 时自动从基准图推断(仅对 gemini-3-pro-image-preview 生效)。
  • 显式传入 aspect_ratio 时优先使用指定宽高比。

改图示例

错误码