PudBot

主题

Google Gemini API ​

兼容 Google Gemini API 格式，适用于 Gemini 客户端、Google AI SDK 等。

端点 ​

POST https://token.pudbot.com/v1beta/models/{model}:generateContent
POST https://token.pudbot.com/v1beta/models/{model}:streamGenerateContent

认证 ​

通过 URL 查询参数传递 API Key：

?key=*** Key

或在 Header 中携带：

x-goog-api-key: *** Key

请求参数 ​

参数类型必填说明
contentsarray是消息数组，参见下方格式
systemInstructionobject否系统提示词
generationConfigobject否生成配置
safetySettingsarray否安全设置

generationConfig ​

字段类型说明
temperaturefloat采样温度，0~2
topPfloat核采样
topKintegerTop-K 采样
maxOutputTokensinteger最大生成 Token 数
stopSequencesarray停止序列

contents 格式 ​

json
[
  {
    "role": "user",
    "parts": [{"text": "你好"}]
  },
  {
    "role": "model",
    "parts": [{"text": "你好！有什么可以帮你的？"}]
  },
  {
    "role": "user",
    "parts": [{"text": "写一首诗"}]
  }
]

支持图片输入：

json
{
  "role": "user",
  "parts": [
    {"text": "这张图是什么？"},
    {"inlineData": {"mimeType": "image/png", "data": "base64编码的图片数据"}}
  ]
}

请求示例 ​

非流式 ​

bash
curl "https://token.pudbot.com/v1beta/models/gemini-2.5-pro:generateContent?key=sk-你的APIKey" \
  -H "content-type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Hello!"}]}],
    "generationConfig": {"maxOutputTokens": 1024}
  }'

流式 ​

bash
curl "https://token.pudbot.com/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-你的APIKey" \
  -H "content-type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "写一首关于编程的诗"}]}],
    "generationConfig": {"maxOutputTokens": 1024}
  }'

响应格式 ​

json
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [{"text": "Hello! How can I help you today?"}]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}

流式响应 ​

流式返回为 JSON 数组流，每个元素包含增量内容：

json
[
  {
    "candidates": [
      {
        "content": {"role": "model", "parts": [{"text": "Hello"}]},
        "finishReason": null,
        "index": 0
      }
    ]
  }
]

流结束时 finishReason 为 "STOP"。

支持的模型 ​

模型说明
gemini-2.5-proGemini 2.5 Pro，最强推理
gemini-2.5-flashGemini 2.5 Flash，快速响应
gemini-2.5-flash-liteGemini 2.5 Flash Lite，轻量版
gemini-2.0-proGemini 2.0 Pro
gemini-2.0-flashGemini 2.0 Flash
gemini-2.0-flash-liteGemini 2.0 Flash Lite
gemini-1.5-proGemini 1.5 Pro
gemini-1.5-flashGemini 1.5 Flash