Guide
OpenAI SDK 迁移到 ClaudeYY 指南
ClaudeYY 完全兼容 OpenAI SDK,从 OpenAI 直连迁移只需修改两个参数:`base_url` 和 `api_key`。
openai-sdkImported5/12/2026
OpenAI SDK 兼容
ClaudeYY 完全兼容 OpenAI SDK,从 OpenAI 直连迁移只需修改两个参数:base_url 和 api_key。
迁移步骤
只需修改两行代码
Python
Terminal
from openai import OpenAI
# 之前:直连 OpenAI
# client = OpenAI(api_key="sk-openai-xxx")
# 现在:通过 ClaudeYY
client = OpenAI(
base_url="https://claude.claudeyy.com/v1", # 新增
api_key="<你的 CLAUDEYY_API_KEY>" # 替换
)
# 其他代码完全不变!
response = client.chat.completions.create(
model="openai/gpt-4o", # 添加 provider 前缀
messages=[{"role": "user", "content": "Hello!"}]
)
TypeScript
Terminal
import OpenAI from 'openai'
// 之前:直连 OpenAI
// const client = new OpenAI({ apiKey: 'sk-openai-xxx' })
// 现在:通过 ClaudeYY
const client = new OpenAI({
baseURL: 'https://claude.claudeyy.com/v1', // 新增
apiKey: '<你的 CLAUDEYY_API_KEY>' // 替换
})
// 其他代码完全不变!
模型命名
ClaudeYY 使用 provider/model-name 格式标识模型:
| OpenAI 原始名称 | ClaudeYY 模型 ID |
|---|---|
gpt-4o | openai/gpt-4o |
gpt-4o-mini | openai/gpt-4o-mini |
gpt-5.2 | openai/gpt-5.4-mini |
text-embedding-3-small | openai/text-embedding-3-small |
通过 ClaudeYY,你还可以使用其他厂商的模型,推荐模型请参考 ClaudeYY 模型广场。
兼容性
ClaudeYY 支持 OpenAI API 的以下功能:
| 功能 | 状态 |
|---|---|
| Chat Completions | ✅ 完全兼容 |
| Streaming | ✅ 完全兼容 |
| Function Calling | ✅ 完全兼容 |
| JSON Mode | ✅ 完全兼容 |
| Vision (图像输入) | ✅ 完全兼容 |
| Embeddings | ✅ 完全兼容 |
| Models List | ✅ 完全兼容 |
| Images Generation | ✅ 完全兼容 |
框架集成
LangChain
Terminal
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://claude.claudeyy.com/v1",
api_key="<你的 CLAUDEYY_API_KEY>",
model="openai/gpt-4o"
)
LlamaIndex
Terminal
from llama_index.llms.openai import OpenAI
llm = OpenAI(
api_base="https://claude.claudeyy.com/v1",
api_key="<你的 CLAUDEYY_API_KEY>",
model="openai/gpt-4o"
)
Vercel AI SDK
Terminal
import { createOpenAI } from '@ai-sdk/openai'
const claudeyy = createOpenAI({
baseURL: 'https://claude.claudeyy.com/v1',
apiKey: '<你的 CLAUDEYY_API_KEY>'
})
const model = claudeyy('openai/gpt-4o')
任何支持 OpenAI SDK 的框架和工具,都可以通过修改 base_url 接入 ClaudeYY。
工具集成