CoreRouter API Docs

CoreRouter API Docs

统一接入 AI 模型，只需要改三个配置。

CoreRouter 提供 OpenAI 兼容接口，也支持常见客户端和 AI 编程工具。用户只需要准备 API Key、Base URL 和 Model ID，就可以开始调用模型。

复制 curl 示例 查看快速开始

接入三要素

不管使用 SDK、客户端还是编程工具，绝大多数配置都围绕下面三项。

配置项 填写内容 说明
Base URL https://api.corerouter.tech/v1 OpenAI 兼容接口地址。Anthropic、Gemini、Midjourney 和 Realtime 使用各自的根地址或 WebSocket 地址。
API Key sk-xxxxxxxxxxxxxxxx 在 CoreRouter 控制台创建，建议通过环境变量保存。
Model ID claude-sonnet-4-5 填写控制台显示的模型 ID，不要填写展示名称。
Model ID 必须与控制台完全一致。例如填写 claude-sonnet-4-5，不要填写 Claude Sonnet。

curl 测试

第一次接入时先用 curl 验证 API Key、网络和模型 ID。curl 成功后，再配置 SDK 或客户端。

bash 
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，说明基础配置可用。更多示例见 curl 接入指南。

API 接入

curl 无需 SDK，适合验证配置和排查错误。 Python 使用 OpenAI Python SDK 接入。 Node.js 使用 OpenAI Node.js SDK，支持 JavaScript 和 TypeScript。 LangChain 用于 Chain、Agent、RAG 等应用场景。 Go HTTP 使用 Go 标准库直接调用，适合服务端和命令行程序。 OpenAPI 查看公开接口规范和路径清单。

Python SDK

python 
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["COREROUTER_API_KEY"],
    base_url="https://api.corerouter.tech/v1",
)

completion = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己。"}
    ],
)

print(completion.choices[0].message.content)

查看 Python 完整指南

Node.js SDK

typescript 
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COREROUTER_API_KEY,
  baseURL: "https://api.corerouter.tech/v1",
});

const completion = await client.chat.completions.create({
  model: "claude-sonnet-4-5",
  messages: [
    { role: "user", content: "你好，请介绍一下你自己。" },
  ],
});

console.log(completion.choices[0].message.content);

查看 Node.js 完整指南

LangChain

LangChain 仍然使用同一组 CoreRouter 参数：API Key、Base URL、Model ID。

python 
from langchain_openai import ChatOpenAI
import os

llm = ChatOpenAI(
    model="claude-sonnet-4-5",
    api_key=os.environ["COREROUTER_API_KEY"],
    base_url="https://api.corerouter.tech/v1",
)

response = llm.invoke("你好，请介绍一下你自己。")
print(response.content)

查看 LangChain 完整指南

更多接口形态

除了 Chat Completions，CoreRouter 还提供 Responses、Anthropic Messages、Gemini-compatible、Embeddings、Rerank、Realtime、图片、音频和视频任务等接口。

接口与能力总览 按场景选择 Endpoint、Base URL、请求格式和模型能力。 Responses API 适合 Codex、Agent 和统一事件流，要求模型支持 Responses。 独立搜索接口 面向特定 Agent 或编程工具，要求搜索兼容能力。 Realtime WebSocket 低延迟语音和文本交互，要求 Realtime 模型。 Anthropic Messages 适合 Claude Code 和 Anthropic 风格客户端。 Gemini 风格接口 适合使用 Gemini API 路径的 SDK 或工具。 Embeddings 用于 RAG、向量检索、相似度计算和聚类。 Rerank 对 RAG 候选文档按查询相关性重排。 审核和旧版补全 Moderations 内容审核和 legacy Completions。 图片和音频 图片生成、图片编辑、语音识别和文字转语音。 视频和异步任务 视频生成、任务轮询、产物下载和通用任务。 Midjourney 风格接口 图片任务提交、按钮操作、状态查询和图片代理。 排错路径 Base URL、状态码、流式输出和 Agent 问题排查。
不同接口的 Base URL 不完全相同。OpenAI 兼容接口一般使用 https://api.corerouter.tech/v1，Claude Code 和 Gemini 风格客户端通常使用 https://api.corerouter.tech。

Cherry Studio 和桌面客户端

Cherry Studio、Chatbox、NextChat、Lobe Chat 等支持 OpenAI Compatible 配置的客户端，通常都可以接入 CoreRouter。

配置项 填写内容
Provider / 类型 OpenAI Compatible
API URL / Base URL https://api.corerouter.tech/v1
API Key CoreRouter 控制台创建的 API Key
Model ID claude-sonnet-4-5

Cherry Studio 下载地址：https://cherryai.com.cn/download。 详细步骤见 桌面客户端接入。

AI 编程工具

编程工具除了能聊天，还要能稳定完成工具调用、流式输出和多轮任务。请优先选择控制台标记支持 Coding Agent 的模型。

工具 API 格式 Base URL 适合场景
Cline OpenAI Compatible https://api.corerouter.tech/v1 配置简单，适合大多数用户。
Claude Code Anthropic Messages https://api.corerouter.tech 使用 Anthropic 风格接口，Base URL 不带 /v1。
Codex OpenAI Responses API https://api.corerouter.tech/v1 需要所选 Model ID 支持 /v1/responses。

Cline

  1. 在 VS Code 扩展市场安装 Cline。
  2. Provider 选择 OpenAI Compatible。
  3. Base URL 填写 https://api.corerouter.tech/v1。
  4. API Key 填写 CoreRouter 控制台创建的 Key。
  5. Model 填写控制台模型 ID，例如 claude-sonnet-4-5。

查看 Cline 完整指南

Claude Code

Claude Code 使用 Anthropic API 风格，环境变量里的 Base URL 不带 /v1。

bash 
export ANTHROPIC_BASE_URL="https://api.corerouter.tech"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-5"

查看 Claude Code 完整指南

Codex

Codex 使用 OpenAI Responses API，需要在用户级 ~/.codex/config.toml 中配置自定义 Provider，并选择支持 Responses 的模型。

toml 
model = "responses-model-id"
model_provider = "corerouter"

[model_providers.corerouter]
name = "CoreRouter"
base_url = "https://api.corerouter.tech/v1"
env_key = "COREROUTER_API_KEY"
wire_api = "responses"
bash 
export COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"

查看 Codex 完整指南

常见问题

401 Unauthorized 检查 API Key 是否正确、是否过期，以及 Header 是否为 Authorization: Bearer sk-...。
400 Bad Request 检查 JSON 格式、必填字段和 Model ID。模型 ID 必须来自控制台。
普通聊天可用，Agent 不可用 通常是模型不支持 Tool Calling、Streaming 或 Coding Agent，建议更换模型测试。
客户端模型列表为空 先用 curl 调用 /v1/models，确认 API Key、Base URL 和账户权限。

详细文档

快速开始 注册、额度、API Key 和第一次调用。 API 接入 curl、Python、Node.js、LangChain。 接口与能力总览 Endpoint、请求格式、模型能力和常见错误。 客户端接入 Cherry Studio 和其他 OpenAI 兼容客户端。 AI 编程工具 Cline、Claude Code、Codex。 常见问题和排错 状态码、Base URL、模型能力、客户端异常。 OpenAPI 接口规范文件。