Gemini Native 图片

Gemini native 图片或多模态请求不走 /v1/images/generations。Gemini 平台分组应使用 /v1beta/models... 路径，并按 Gemini 原生请求体传参。

查询模型列表

项目	值
Method	GET
Path	/v1beta/models
认证	Authorization: Bearer YOUR_API_KEY
平台要求	Gemini 平台分组

curl https://llmapi.site/v1beta/models \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应会返回当前 Gemini 分组可用模型。实际可用范围取决于分组账号、模型映射、账号状态和上游配额。

查询单个模型

项目	值
Method	GET
Path	/v1beta/models/{model}

curl https://llmapi.site/v1beta/models/gemini-2.5-flash-image \
  -H 'Authorization: Bearer YOUR_API_KEY'

生成图片或多模态内容

项目	值
Method	POST
Path	/v1beta/models/{model}:generateContent
Content-Type	application/json
认证	Authorization: Bearer YOUR_API_KEY

Path 参数：

参数	类型	必填	说明
model	string	是	Gemini native 模型名，例如 gemini-2.5-flash-image。

Body 参数：

参数	类型	必填	说明
contents	array	是	Gemini 原生消息内容。文本、图片输入都放在 parts 中。
systemInstruction	object	否	Gemini 原生系统指令。
generationConfig	object	否	Gemini 原生生成配置。图片输出模型通常需要按上游能力设置 responseModalities。
safetySettings	array	否	Gemini 原生安全设置，按上游能力透传。

文本生图示例：

curl https://llmapi.site/v1beta/models/gemini-2.5-flash-image:generateContent \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Generate a clean studio product image of a matte black water bottle on a white background." }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'

带输入图片的多模态示例：

curl https://llmapi.site/v1beta/models/gemini-2.5-flash-image:generateContent \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Create a new product image using this object, with a bright studio background." },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'

流式调用

POST /v1beta/models/{model}:streamGenerateContent?alt=sse

curl -N 'https://llmapi.site/v1beta/models/gemini-2.5-flash-image:streamGenerateContent?alt=sse' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Generate a square product image of a ceramic coffee cup." }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'

常见错误

错误	说明
API key group platform is not gemini	当前 API Key 不属于 Gemini 平台分组。
No available Gemini accounts	分组下没有可用 Gemini 账号，或账号不支持请求模型。
上游 4xx/5xx	请求体、模型、配额或上游账号能力不满足 Gemini 原生接口要求。