Gemini 相容 API

GetRouter 提供 Gemini 相容的模型清單與內容生成端點。

GET  https://getrouter.ai/v1beta/models
POST https://getrouter.ai/v1beta/models/{model}:generateContent

請將 {model} 替換成完整且正確的模型 ID。

列出模型

curl https://getrouter.ai/v1beta/models \
  -H "x-goog-api-key: YOUR_API_KEY"

回應採用 Gemini 相容的模型清單結構。

生成內容

curl "https://getrouter.ai/v1beta/models/MODEL_ID:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "用兩句話說明 API 路由。"}
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.4,
      "maxOutputTokens": 256
    }
  }'

生成的內容會在 Gemini 相容的 candidates 結構中傳回。用量資訊可能會在 usageMetadata 中傳回。

請求欄位

generateContent 結構描述包含：

使用 user 或 model 角色的 contents
文字部分
包含 mimeType 與 Base64 data 的內嵌資料部分
generationConfig，包括 temperature、top-p、top-k、輸出 token 數量上限及停止序列
safetySettings
tools
systemInstruction

支援情況取決於模型。加入多模態輸入、工具或模型專屬設定前，請先從純文字內容開始測試。

內嵌資料範例

相容的多模態模型可以接受內嵌資料部分：

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "描述附加的圖像。"},
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ]
}

Gemini 圖片生成酬載

若模型支援圖片生成，同一個 generateContent 路徑也可能接受回應模態、圖片設定等參數。傳送這類請求時，請以該模型的官方說明與 API 參考中的範例為準。

相容性注意事項

Gemini 相容用戶端建立 URL 的方式可能與 OpenAI 相容用戶端不同。
除非整合指南明確要求該值，否則請勿在 Gemini 用戶端中輸入 https://getrouter.ai/v1。
確認用戶端需要的是 API 根路徑、API 版本路徑，還是完整的操作端點。

#Gemini 相容 API

#列出模型

#生成內容

#請求欄位

#內嵌資料範例

#Gemini 圖片生成酬載

#相容性注意事項

#後續步驟