从 OpenAI SDK 迁移

如果你已有基于 OpenAI 官方 SDK（或任何 OpenAI 兼容 SDK）的项目，迁移到 primerouter 通常只需改一行：把 base_url 指向 https://primerouter.ai/v1，把 api_key 换成 primerouter 的 key。

Python

之前：

python

from openai import OpenAI
client = OpenAI(api_key="sk-openai-...")

之后：

python

from openai import OpenAI
client = OpenAI(
    api_key="sk-primerouter-...",
    base_url="https://primerouter.ai/v1",  # 改这一行
)

业务代码（client.chat.completions.create(...)）完全不变——原有 gpt-4o、claude-3-5-sonnet、gemini-1.5-pro 等模型名继续可用，也可以直接换成 primerouter 主推的中国前沿模型如 deepseek-chat、qwen-max、glm-4-plus、moonshot-v1-8k。

TypeScript / JavaScript

const client = new OpenAI({
  apiKey: process.env.PRIMEROUTER_KEY,
  baseURL: 'https://primerouter.ai/v1',
})

Go（langchaingo / sashabaranov/go-openai）

config := openai.DefaultConfig("sk-primerouter-...")
config.BaseURL = "https://primerouter.ai/v1"
client := openai.NewClientWithConfig(config)

流行工具配置

AI 编程工具单独成文

Cursor / Cline / Claude Code / OpenCode / Crush / Codex CLI / Vibecode 的逐步配置（含 macOS / Linux / Windows 命令、配置文件路径、env 变量持久化方式）已经独立成页：

👉 编程工具接入

本节只列聊天 / 工作流类工具。

工具	base_url 配置位置
LobeChat	模型服务商 → OpenAI → API 代理地址
ChatBox	模型 → OpenAI → API Host
NextChat	设置 → 接口地址
n8n	OpenAI 节点 → Credentials → Base URL
Open WebUI	Settings → Connections → OpenAI API
Dify	模型供应商 → OpenAI-API-compatible → API endpoint

模型映射

primerouter 不要求你改模型名——原本的 OpenAI / Anthropic / Gemini 模型名仍可继续调用。同时强烈推荐切换到性价比更高的中国前沿模型：

你写	实际路由到	备注
`gpt-4o`、`gpt-4o-mini`	OpenAI	原模型保留
`claude-3-5-sonnet`、`claude-opus-4`	Anthropic	原模型保留
`gemini-1.5-pro`、`gemini-2.0-flash`	Google	原模型保留
`deepseek-chat`、`deepseek-reasoner`	DeepSeek	⭐ 推荐：综合性能对标 GPT-4o，价格约 1/10
`qwen-max`、`qwen-plus`、`qwen-turbo`	阿里通义	⭐ 强中文
`moonshot-v1-8k`、`moonshot-v1-128k`	Kimi（Moonshot）	⭐ 超长上下文
`glm-4`、`glm-4-plus`	智谱 GLM	⭐ 综合表现强
`minimax-m1`	MiniMax
`doubao-pro`	字节豆包

完整模型列表与定价：Pricing → Models。

兼容性边界

primerouter 努力做到调用层 100% 兼容，但有少数情况需要注意：

不存在的模型名：返回 400 + 明确错误信息，不会静默回退到其他模型。
上游未实现的能力：例如对 GPT-3.5 用 tool_choice="required"——会原样透传上游错误。
stream_options：所有支持流的模型都支持 include_usage: true。

从 OpenAI SDK 迁移 ​

Python ​

TypeScript / JavaScript ​

Go（langchaingo / sashabaranov/go-openai） ​

流行工具配置 ​

模型映射 ​

兼容性边界 ​

下一步 ​