开发者文档

完整的 API 文档,兼容 OpenAI 接口标准

POST/v1beta/models/{model}:generateContent

原生 Gemini 格式

使用原生 Gemini 格式进行内容生成,支持 Gemini Pro 和 Gemini Pro Vision。

请求地址

POST https://token.wlj.weifaner.net:8001/v1beta/models/gemini-pro:generateContent

请求头

参数名类型必填说明
x-goog-api-keystringAPI 密钥
Content-Typestringapplication/json

请求体

参数名类型必填说明
contentsarray内容数组,包含角色和部件
generationConfigobject生成配置(温度、topK、topP 等)
safetySettingsarray安全设置

请求示例

curl -X POST "https://token.wlj.weifaner.net:8001/v1beta/models/gemini-pro:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "你好,Gemini!"}
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

响应示例

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "你好!很高兴见到你。有什么我可以帮助你的吗?"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [...]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 15,
    "totalTokenCount": 20
  }
}

最后更新于 2026/5/25