GetRouter文档
  • 简体中文

    • Gemini 兼容 API

    GetRouter 提供 Gemini 兼容的模型列表和内容生成接口。Gemini 协议与 OpenAI 兼容协议使用不同的 URL、请求结构和响应字段。

    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 schema 包括：

    • contents，支持 user 或 model 角色；
    • 文本 parts；
    • 包含 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 路径可能支持响应模态和图片配置等参数。请以模型的能力说明和接口参考中的示例为准。

    兼容性注意事项

    • Gemini 兼容工具构造 URL 的方式可能与 OpenAI 兼容工具不同。
    • 除非集成指南明确要求，否则不要将 https://getrouter.ai/v1 填入 Gemini 客户端。
    • 确认客户端需要的是 API 根地址、带版本的 API 地址，还是完整的操作接口地址。

    下一步