跳到主要内容

OpenRouter API 配置指南

概述​

OpenRouter API 是一个聚合多家大模型服务的统一接口平台，支持访问 OpenAI、Anthropic、Google、Meta 等多个厂商的模型。

通过 OpenRouter，你可以：

  • 使用统一 API 调用不同厂商模型
  • 自动路由到最优模型或最低成本节点
  • 避免单一平台限流问题
  • 灵活切换模型，无需更改代码

常见可用模型：

模型提供商特点适用场景
openai/gpt-4o-miniOpenAI快速、低成本日常对话
openai/gpt-4oOpenAI高质量多模态任务
anthropic/claude-3-haikuAnthropic速度快轻量任务
anthropic/claude-3-opusAnthropic高推理能力复杂分析
google/gemini-proGoogle强多模态综合任务

获取 API Key​

步骤 1：访问 OpenRouter​

前往 OpenRouter

步骤 2：登录账号​

支持使用 GitHub / Google 登录。

步骤 3：创建 API Key​

  1. 进入 Dashboard → Keys
  2. 点击 Create Key
  3. 复制并保存 生成的 API Key

⚠️ 注意：请妥善保存 API Key，避免泄露。

OpenRouter API Key

OpenRouter API Key​

配置 PicoClaw​

方式一：使用 WebUI（推荐）​

PicoClaw 提供了 WebUI 界面，您可以在 WebUI 中轻松配置模型，无需手动编辑配置文件。

编辑预设设置，或在右上角点击 "添加模型" 按钮进行配置：

添加模型

字段填写内容
模型别名自定义名称，如 gpt-4o-mini
模型标识符openai/gpt-4o-mini（或其他支持的模型）
API KeyOpenRouter API Key
API Base URLhttps://openrouter.ai/api/v1

方式二：编辑配置文件​

在 config.json 中添加：

{
  "model_list": [
    {
      "model_name": "gpt-4o-mini",
      "model": "openai/gpt-4o-mini",
      "base_url": "https://openrouter.ai/api/v1",
      "auth_method": "api_key",
      "api_key": "YOUR_OPENROUTER_API_KEY",
      "headers": {
        "HTTP-Referer": "http://localhost",
        "X-Title": "PicoClaw"
      }
    },
    {
      "model_name": "claude-3-haiku",
      "model": "anthropic/claude-3-haiku",
      "base_url": "https://openrouter.ai/api/v1",
      "auth_method": "api_key",
      "api_key": "YOUR_OPENROUTER_API_KEY"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gpt-4o-mini"
    }
  }
}

限制与配额​

计费方式​

OpenRouter 采用 按使用量计费 模式，根据实际使用的模型和 Token 数量收费。

速率限制​

  • 不同模型有不同的速率限制
  • 免费模型可能有更严格的限制
  • 付费用户享有更高的速率配额

常见问题​

模型不可用​

原因：模型已下架或账户余额不足

解决：

  • 检查模型是否仍然可用
  • 充值账户余额

响应超时​

原因：模型响应较慢或网络问题

解决：

  • 尝试使用更快的模型
  • 检查网络连接