Gemini Native

Gemini 分组使用 Gemini Native API 处理文本、图片和多模态请求。当 API Key 绑定 Gemini 分组时，请使用这些接口。

查询模型列表

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

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

响应会返回当前 Gemini 分组可用的模型。

响应示例：

{
  "models": [
    {
      "name": "models/gemini-2.5-flash-image",
      "displayName": "gemini-2.5-flash-image",
      "supportedGenerationMethods": ["generateContent"]
    }
  ]
}

查询单个模型

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

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

响应示例：

{
  "name": "models/gemini-2.5-flash-image",
  "displayName": "gemini-2.5-flash-image",
  "supportedGenerationMethods": ["generateContent"]
}

生成内容

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

Path 参数：

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

常用 Body 参数：

参数	类型	必填	说明
contents	array	是	Gemini 内容数组。文本和图片输入都放在 parts 中。
systemInstruction	object	否	系统指令。
generationConfig	object	否	生成配置。图片模型可设置 responseModalities 和 imageConfig。
safetySettings	array	否	安全设置。

文本生图示例：

curl https://api.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"],
      "imageConfig": {
        "imageSize": "1K"
      }
    }
  }'

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

curl https://api.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"],
      "imageConfig": {
        "imageSize": "1K"
      }
    }
  }'

响应示例：

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Generated result text."
          }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}

流式调用

客户端需要增量接收 Gemini 响应时，可以使用流式接口。

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

curl -N 'https://api.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"]
    }
  }'

流式响应使用 Gemini 兼容的 SSE 分块。客户端应按 data: 事件解析每个 Gemini 响应对象。

错误码

状态码	原因
400	请求体、模型名或 Gemini payload 无效。
401	API Key 缺失或无效。
403	当前 API Key 分组不是 Gemini，或额度/余额校验失败。
404	当前 Gemini 分组不可用该模型。
429	达到频率限制或并发限制。
500 / 502 / 503	网关或上游 Gemini 账号失败。