文档 · 入门
SDK 与客户端
我们不发布自己的 SDK。任何能讲 OpenAI /v1 的客户端都能 drop-in 接入，只需改 base_url 与 api_key 两个变量。
§ 01
已验证客户端
- openai-python ≥ 1.40
- 官方 SDK，推荐
- openai-node ≥ 4.55
- Node / Edge runtimes 均可
- langchain (py & js)
- ChatOpenAI、OpenAIEmbeddings 直接可用
- vercel/ai-sdk
- createOpenAI({ baseURL })
- llama-index
- LlamaIndex OpenAI / OpenAILike
- dify · cherry studio · cline · roo
- 自定义 OpenAI 兼容端点即可
- Anthropic SDK
- 仅 Anthropic 子集端点 /v1/messages（路线图中）
§ 02
LangChain (Python)
from langchain_openai import ChatOpenAI, OpenAIEmbeddings
chat = ChatOpenAI(
model="auto",
base_url="https://api.cdgo.ai/v1",
api_key="sk-cdgo-...",
)
embed = OpenAIEmbeddings(
model="bge-m3",
base_url="https://api.cdgo.ai/v1",
api_key="sk-cdgo-...",
)§ 03
Vercel AI SDK
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
const cdgo = createOpenAI({
baseURL: "https://api.cdgo.ai/v1",
apiKey: process.env.CDGO_API_KEY!,
});
const { text } = await generateText({
model: cdgo("auto"),
prompt: "summarise this PR title",
});§ 04
环境变量约定
我们建议把 OPENAI_BASE_URL 与 OPENAI_API_KEY 直接指到 cdgo.ai —— 这样老的脚本无需任何修改即可切换。
export OPENAI_BASE_URL="https://api.cdgo.ai/v1" export OPENAI_API_KEY="sk-cdgo-..."