Gemini 原生协议

如果你使用 Gemini SDK 或习惯 Gemini 原生 API 格式，可以直接通过此端点调用，无需转换为 OpenAI 格式。

请求

POST /v1beta/models/{model}:{action}

也支持带前缀的路径（兼容旧配置）：

POST /gemini/v1beta/models/{model}:{action}

路径参数

参数	说明	示例
model	模型名称	gemini-3-flash
action	操作类型	generateContent、streamGenerateContent

Headers

Header	值
Authorization	Bearer sk-你的API密钥
Content-Type	application/json

Body（generateContent）

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "你好，请介绍一下自己"}
      ]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "maxOutputTokens": 1024
  }
}

多模态（图片输入）

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "描述这张图片"},
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "base64编码的图片数据..."
          }
        }
      ]
    }
  ]
}

生图请求

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "画一只可爱的猫咪"}
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"]
  }
}

响应

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "你好！我是 AI 助手..."}
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 20,
    "totalTokenCount": 25
  }
}

生图响应（含图片）

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "好的，这是一只可爱的猫咪："},
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "base64编码..."
            }
          }
        ]
      }
    }
  ]
}

示例

文本对话

curl -X POST "https://pico.5884.cn/gemini/v1beta/models/gemini-3-flash:generateContent" \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "你好"}]}
    ]
  }'

流式对话

curl -X POST "https://pico.5884.cn/gemini/v1beta/models/gemini-3-flash:streamGenerateContent" \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "写一首诗"}]}
    ]
  }'

协议转换

网关会根据上游渠道类型自动处理：

上游类型	处理方式
Gemini 渠道	直接透传，无转换
OpenAI 渠道	自动将 Gemini 格式转为 OpenAI 格式发送，响应转回 Gemini 格式

tip

如果你的应用已经集成了 Gemini SDK，只需将 base URL 改为 https://pico.5884.cn/gemini，API Key 改为 PicoPapa 的 Key，即可无缝切换。