SDK 接入

适用角色：开发者 更新日期：2026-07-02

CloudRouter 兼容 OpenAI 和 Anthropic 的官方 SDK。无需更换 SDK，只改两行配置（Base URL + API Key）即可把现有代码切到 CloudRouter。

API 地址为 https://api.cloudrouter.online，路由前缀 /v1，认证用 Authorization: Bearer sk-xxx。

---

一、OpenAI Python SDK

最常用的接入方式。已有 OpenAI 代码时，改两行即可：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",                          # ← 改成 CloudRouter 的 Key
    base_url="https://api.cloudrouter.online/v1"     # ← 加这一行
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

安装：pip install openai

---

二、OpenAI Node.js SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.cloudrouter.online/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-4-6",
  messages: [{ role: "user", content: "你好" }],
});

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

安装：npm install openai

---

三、Anthropic SDK

如果你用 Claude 原生 SDK，改 base_url 指向 CloudRouter：

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.cloudrouter.online"
)

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.content[0].text)

安装：pip install anthropic

Anthropic SDK 走 /v1/messages 端点，max_tokens 为必填参数。

---

四、其他语言 / 通用范式

CloudRouter 是标准 HTTP API，任何能发 HTTP 请求的语言都能接入。

Go

// 使用 OpenAI 兼容端点，设置自定义 BaseURL
config := openai.DefaultConfig("YOUR_API_KEY")
config.BaseURL = "https://api.cloudrouter.online/v1"
client := openai.NewClientWithConfig(config)

通用 curl（任何环境）

curl https://api.cloudrouter.online/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"你好"}]}'

---

五、接入检查清单

迁移到 CloudRouter 时，逐项确认：

• [ ] base_url / baseURL 已指向 CloudRouter
• [ ] api_key 已换成 CloudRouter 的 Key（sk- 开头）
• [ ] model 字段填的是从控制台「调用指南」复制的调用名（裸名或带指纹均可）
• [ ] 目标分组 / 模型在你账户的可用范围内
• [ ] 业务代码其余部分无需改动

model 字段裸名与带指纹两种写法的区别见 调用指南与双路由。

---

下一步

• 搞清楚 model 字段写法 → 调用指南与双路由
• 接 Claude Code / Cursor / 框架 → 第三方工具接入
• 处理报错 → 错误码与排障

---

联系我们

• 电子邮箱：support_cloudrouter@clouditera.com
• QQ 社群：712273971
• 平台网址：cloudrouter.online