快速开始 #

第一次使用 CoreRouter，只需要完成三件事：创建 API Key、选择模型 ID、把接口地址填到客户端或代码里。

一分钟配置 #

请使用控制台里的 Model ID，不要填写模型展示名称。例如填写 claude-sonnet-4-5，不要填写 Claude Sonnet。

先确认你使用的接口类型 #

如果客户端会自动拼接完整路径，可能只需要填写 https://api.corerouter.tech。如果客户端要求 OpenAI Compatible Base URL，通常填写 https://api.corerouter.tech/v1。

使用步骤 #

1. 注册并登录 CoreRouter 控制台。
2. 在钱包或兑换页面准备可用额度。
3. 在 API Keys 页面创建 API Key，可按需要设置额度、过期时间、可用模型和 IP 限制。
4. 复制控制台中的模型 ID。
5. 用下面的 curl 请求测试。

export COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"

curl https://api.corerouter.tech/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COREROUTER_API_KEY" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己。"
      }
    ]
  }'

返回包含 choices 的 JSON，说明 API Key、接口地址和模型 ID 都已配置正确。

保存环境变量 #

macOS / Linux：

export COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"
export COREROUTER_BASE_URL="https://api.corerouter.tech/v1"
export COREROUTER_MODEL="claude-sonnet-4-5"

Windows PowerShell：

$env:COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"
$env:COREROUTER_BASE_URL="https://api.corerouter.tech/v1"
$env:COREROUTER_MODEL="claude-sonnet-4-5"

部署到服务器、容器、函数计算或 CI 时，请使用平台提供的 Secret / Environment Variables 功能保存 API Key，不要把 Key 写进源代码。

下一步 #

• API 接入：适合 Python、Node.js、LangChain 和服务端项目。
• 接口与能力总览：适合确认 Endpoint、Base URL 和模型能力。
• 桌面客户端：适合 Cherry Studio 等图形客户端。
• AI 编程工具：适合 Cline、Claude Code、Codex 等开发工具。
• 常见问题和排错：适合定位 401、403、429、Base URL 和 Agent 问题。

常见检查项 #

• 401：API Key 错误、过期、复制时带了空格，或 Header 不是 Authorization: Bearer ...。
• 400：JSON 格式错误，或 model 字段不是控制台里的 Model ID。
• 403：API Key 权限、模型权限、IP 限制或账户权限不满足。
• 429：请求过快或触发限流，降低并发后重试。
• 无响应或超时：先用 curl https://api.corerouter.tech/v1/models 检查网络和 Key。
• Agent 不工作：普通聊天模型不一定支持工具调用，请换用支持 Coding Agent 的模型。

查询可用模型 #

curl https://api.corerouter.tech/v1/models \
  -H "Authorization: Bearer $COREROUTER_API_KEY"