接入 Google Gemini

Google Gemini 通过 Google AI Studio API 提供 Gemini 模型能力。使用 API7 AI 网关可以把 Gemini 调用纳入统一的接口入口、访问控制、日志审计和限流策略。

前提条件

• 已安装 Docker 和 cURL。
• 已有可用的 API7 企业版网关环境。
• 已设置 ADMIN_API_KEY 和 SERVICE_ID 环境变量。

获取 Gemini 访问密钥

在 Google AI Studio生成访问密钥，并写入环境变量：

export GEMINI_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxx

配置 Gemini 代理

Admin API

curl "http://127.0.0.1:7080/apisix/admin/routes?gateway_group_id=default" -X PUT \
  -H "X-API-KEY: $ADMIN_API_KEY" \
  -d '{
  "id": "gemini-route",
  "service_id": "'"$SERVICE_ID"'",
  "paths": ["/gemini"],
  "plugins": {
    "ai-proxy": {
      "provider": "gemini",
      "auth": {
        "header": {
          "Authorization": "Bearer '"$GEMINI_API_KEY"'"
        }
      },
      "options": {
        "model": "gemini-2.0-flash"
      }
    }
  }
}'

ADC

adc.yaml

services:
  - name: Gemini Service
    routes:
      - name: gemini-route
        uris:
          - /gemini
        plugins:
          ai-proxy:
            provider: gemini
            auth:
              header:
                Authorization: Bearer ${GEMINI_API_KEY}
            options:
              model: gemini-2.0-flash

后续建议

• 使用消费者或消费者组区分不同业务团队的调用配额。
• 对外部输入启用提示词防护和内容审核。
• 如果企业使用 Google Cloud 企业能力，也可以参考 Vertex AI 接入方式。