通过 OpenRouter 接入多种大模型

OpenRouter 提供兼容 OpenAI 协议的统一接口，可访问多个模型服务提供方的模型。通过 API7 AI 网关接入 OpenRouter 后，你可以继续在网关层统一管理认证、访问控制、限流、日志和审计。

前提条件

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

获取 OpenRouter 访问密钥

在 OpenRouter 创建账号并生成访问密钥：

export OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxxxxxxxxxx

配置 OpenRouter 代理

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": "openrouter-route",
  "service_id": "'"$SERVICE_ID"'",
  "paths": ["/openrouter"],
  "plugins": {
    "ai-proxy": {
      "provider": "openrouter",
      "auth": {
        "header": {
          "Authorization": "Bearer '"$OPENROUTER_API_KEY"'"
        }
      },
      "options": {
        "model": "anthropic/claude-sonnet-4-20250514"
      }
    }
  }
}'

ADC

adc.yaml

services:
  - name: OpenRouter Service
    routes:
      - name: openrouter-route
        uris:
          - /openrouter
        plugins:
          ai-proxy:
            provider: openrouter
            auth:
              header:
                Authorization: Bearer ${OPENROUTER_API_KEY}
            options:
              model: anthropic/claude-sonnet-4-20250514

使用建议

• OpenRouter 适合快速评估多模型效果，但生产环境仍建议明确记录模型选择、限流配额和成本归属。
• 对关键业务配置备用模型，避免单一模型不可用或配额耗尽。
• 对不同业务团队使用独立消费者和审计标签，便于后续分析用量。