/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)
封控但已计费的错误响应
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时优先使用指定宽高比。