跳转到主要内容

​
Gemini 原生格式

Crazyrouter 支持 Google Gemini 的原生 API 格式，包括 generateContent 和 streamGenerateContent 端点。

​
端点

POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent

​
认证

通过 URL 参数传入 API Key： 
?key=YOUR_API_KEY

​
文本生成

curl "https://crazyrouter.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "用简单的语言解释什么是机器学习"}
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

​
响应格式

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "机器学习是人工智能的一个分支..."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 150,
    "totalTokenCount": 162
  }
}

​
流式生成

curl "https://crazyrouter.com/v1beta/models/gemini-2.5-flash:streamGenerateContent?key=YOUR_API_KEY&alt=sse" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "写一篇关于人工智能未来的短文"}]
      }
    ]
  }'

​
多轮对话

cURL
curl "https://crazyrouter.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "你好，我想学习编程"}]
      },
      {
        "role": "model",
        "parts": [{"text": "你好！学习编程是个很好的选择。你有什么特定的方向吗？"}]
      },
      {
        "role": "user",
        "parts": [{"text": "我想学 Python，从哪里开始？"}]
      }
    ]
  }'

​
思考模式

Gemini 思考模型支持在回答前进行推理：
cURL
curl "https://crazyrouter.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "解这个方程：x^3 - 6x^2 + 11x - 6 = 0"}]
      }
    ],
    "generationConfig": {
      "thinkingConfig": {
        "thinkingBudget": 8000
      },
      "maxOutputTokens": 16000
    }
  }'

​
generationConfig 参数

参数类型说明
temperaturenumber采样温度，0-2
maxOutputTokensinteger最大输出 Token 数
topPnumber核采样参数
topKintegerTop-K 采样
stopSequencesarray停止序列
responseMimeTypestring响应 MIME 类型，如 application/json
responseSchemaobjectJSON Schema 约束输出格式
thinkingConfigobject思考模式配置
Gemini 原生格式使用 contents 数组和 parts 结构，与 OpenAI 的 messages 格式不同。如果你更习惯 OpenAI 格式，可以使用 Gemini OpenAI 兼容格式。