提供商配置

配置 LLM 提供商的详细指南。

支持的提供商

DeepSeek

{
  "name": "deepseek",
  "api_base_url": "https://api.deepseek.com/chat/completions",
  "api_key": "your-api-key",
  "models": ["deepseek-chat", "deepseek-coder", "deepseek-reasoner"],
  "transformer": {
    "use": ["deepseek"]
  }
}

Groq

{
  "name": "groq",
  "api_base_url": "https://api.groq.com/openai/v1/chat/completions",
  "api_key": "your-api-key",
  "models": ["llama-3.3-70b-versatile"]
}

Gemini

{
  "name": "gemini",
  "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
  "api_key": "your-api-key",
  "models": ["gemini-2.5-flash", "gemini-2.5-pro"],
  "transformer": {
    "use": ["gemini"]
  }
}

OpenRouter

{
  "name": "openrouter",
  "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
  "api_key": "your-api-key",
  "models": [
    "anthropic/claude-3.5-sonnet",
    "google/gemini-2.5-pro-preview"
  ],
  "transformer": {
    "use": ["openrouter"]
  }
}

Mistral

{
  "name": "mistral",
  "api_base_url": "https://api.mistral.ai/v1/chat/completions",
  "api_key": "your-api-key",
  "models": ["mistral-large-latest", "mistral-small-latest"],
  "transformer": {
    "use": ["mistral"]
  }
}

Cerebras

{
  "name": "cerebras",
  "api_base_url": "https://api.cerebras.ai/v1/chat/completions",
  "api_key": "your-api-key",
  "models": ["cerebras-gpt"],
  "transformer": {
    "use": ["cerebras"]
  }
}

Codex（ChatGPT）

需要通过 ccr codex-auth 完成 OAuth 认证。

{
  "name": "codex",
  "baseUrl": "https://chatgpt.com/backend-api/codex",
  "apiKey": "oauth_dummy_key",
  "models": ["gpt-5", "gpt-5-high", "gpt-5-mini"],
  "transformer": {
    "use": ["codex"]
  }
}

Qwen Chat

需要通过 ccr qwen-auth 完成 JWT 认证。

{
  "name": "qwen",
  "baseUrl": "https://qwen.aikit.club/v1/chat/completions",
  "apiKey": "oauth_dummy_key",
  "models": ["qwen-max", "qwen-plus", "qwen-turbo"],
  "transformer": {
    "use": ["qwen-auth", "reasoning", "OpenAI"]
  }
}

Chrome 内置模型（Gemini Nano）

需要运行 ccr chrome-bridge 桥接进程。

{
  "name": "chrome",
  "baseUrl": "http://127.0.0.1:9229",
  "apiKey": "dummy",
  "models": ["gemini-nano"],
  "transformer": {
    "use": ["chrome-on-device"]
  }
}

Ollama（本地模型）

{
  "name": "ollama",
  "api_base_url": "http://localhost:11434/v1/chat/completions",
  "api_key": "ollama",
  "models": ["qwen2.5-coder:latest"]
}

火山引擎

{
  "name": "volcengine",
  "api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",
  "api_key": "your-api-key",
  "models": ["deepseek-v3-250324", "deepseek-r1-250528"],
  "transformer": {
    "use": ["deepseek"]
  }
}

ModelScope

{
  "name": "modelscope",
  "api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
  "api_key": "",
  "models": [
    "Qwen/Qwen3-Coder-480B-A35B-Instruct",
    "Qwen/Qwen3-235B-A22B-Thinking-2507"
  ],
  "transformer": {
    "use": [
      ["maxtoken", { "max_tokens": 65536 }],
      "enhancetool"
    ],
    "Qwen/Qwen3-235B-A22B-Thinking-2507": {
      "use": ["reasoning"]
    }
  }
}

DashScope（阿里云）

{
  "name": "dashscope",
  "api_base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
  "api_key": "your-api-key",
  "models": ["qwen3-coder-plus"],
  "transformer": {
    "use": [
      ["maxtoken", { "max_tokens": 65536 }],
      "enhancetool"
    ]
  }
}

提供商配置选项

字段	类型	必填	说明
name	string	是	提供商的唯一标识符
api_base_url	string	是	API 基础 URL
api_key	string	是	API 认证密钥
models	string[]	否	可用模型列表
transformer	object	否	应用的转换器配置

模型选择

在路由中选择模型时，使用以下格式：

{provider-name},{model-name}

例如：

deepseek,deepseek-chat

使用环境变量

您可以在配置中使用环境变量来保护 API 密钥：

{
  "Providers": [
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions",
      "api_key": "$DEEPSEEK_API_KEY",
      "models": ["deepseek-chat"]
    }
  ]
}

支持 $VAR_NAME 和 ${VAR_NAME} 两种语法。

转换器配置

转换器用于适配不同提供商的 API 差异。您可以在提供商级别或模型级别配置转换器：

提供商级别转换器

应用于提供商的所有模型：

{
  "name": "openrouter",
  "transformer": {
    "use": ["openrouter"]
  }
}

模型级别转换器

应用于特定模型：

{
  "name": "deepseek",
  "transformer": {
    "use": ["deepseek"],
    "deepseek-chat": {
      "use": ["tooluse"]
    }
  }
}

下一步

• 路由配置 - 配置请求如何路由
• 转换器 - 对请求应用转换