gemini-3-pro-image API

通过 Modelflare 使用 gemini-3-pro-image，使用本页显示的精确模型 ID。

使用精确模型 ID gemini-3-pro-image。请求中的模型名必须与本页完全一致。

认证与入口

使用 Modelflare API Key，通过 https://modelflare.dev 发送请求。网关入口为 POST /v1beta/models/{model}:generateContent。

Authorization: Bearer YOUR_MODELFLARE_API_KEY

生成请求

curl "https://modelflare.dev/v1beta/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "一只白猫在雨夜霓虹街道上奔跑"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}
  }'

请求要点

Gemini 图片模型使用原生 contents 和 generationConfig；编辑时在同一 parts[] 中发送文字指令与 inline_data。

请求参数

Gemini 图片模型使用原生 Gemini generateContent。文本和参考图片都放在同一个 contents[].parts[] 中，图片以 inline_data 提供。不要把这些模型发到 /v1/images/generations、/v1/images/edits 或 OpenAI /v1/responses。

字段	必填	说明
contents[].parts[].text	是	文字提示或编辑指令
contents[].parts[].inline_data	否	Base64 图片及 MIME 类型
generationConfig.responseModalities	是	["IMAGE"] or ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	否	1:1 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	否	1K / 2K / 4K

响应与输入限制

响应从 candidates[].content.parts[] 读取；图像结果位于 inline_data，文字结果位于 text。编辑请求把文字指令和同一 parts[] 中的图片一起发送。公开契约是 Gemini 原生 generateContent，不是 OpenAI Images 或 /v1/responses。

支持范围

本页只覆盖 Modelflare 的模型生成/编辑调用。搜索或地图增强、声音管理、元素库管理等资源型接口不属于本页的公开调用范围，也不需要作为模型请求字段传入。

价格与计费

本模型按 Token 计费。请查看模型价格页查看当前销售价、参考原价和完整规格。

本页只说明 Modelflare 的公开接口；可用字段和限制以本页当前版本为准。