SDK
现有代码不用重写
继续用 OpenAI 官方 SDK。改的是 baseURL 和 apiKey，不是调用方式。
OpenAI SDK / Two Lines
现有 OpenAI SDK，
改两行就能调用
GPT 与 Claude。
不必换 SDK，也不必分别开户。把 baseURL 换成 Viafold，填入一把 API Key，原来的 Chat Completions 和 Responses 调用继续用。
模型名称换成目录里的 Claude，同一套代码也能走 Anthropic。 一份余额覆盖全部调用，按实际用量计费。
创建后，把右侧三项配置填进现有 OpenAI 客户端即可。
01 / CONFIGURATION
OpenAI SDK 配置
- 01baseURL
https://llm.viafold.dev/v1只填到 /v1，不要带 /chat/completions- 02apiKey
<YOUR_API_KEY>- 03model
gpt-6-sol
const client = new OpenAI({
apiKey: "<YOUR_API_KEY>",
baseURL: "https://llm.viafold.dev/v1",
});
const response = await client.chat.completions.create({
model: "gpt-6-sol",
messages: [{ role: "user", content: "Hello" }],
});02 / OUTPUT
同样一套 SDK，
接到更多模型。
更强的模型不是让你重写客户端，而是让现有调用能换模型、对账更清楚。
模型
GPT 与 Claude 同一把钥匙
密钥不绑定模型。目录里的文本模型都可以直接填进 model 字段。
计费
一份余额覆盖全部调用
不必分别为 OpenAI 和 Anthropic 开户充值，按实际 token 结算。
03 / DIFFERENCE
真正省事的，
是少开几个账户。
直连官方当然能用，但每换一个提供商就要新密钥、新账单、新额度。 客户端里堆一堆环境变量，对账时还要对好几份发票。
别人还在给第二个提供商开户，你已经在现有 SDK 里换了模型。
Viafold 把 OpenAI 兼容接口和 Anthropic 模型放进同一把密钥。 改的是两行配置，不是整套接入。
04 / CHECK
配好了，为什么还不能用？
先看错误码，再核对对应字段。不要通过反复更换所有配置来碰运气，这会让真正的问题更难定位。
401 / Unauthorized
API Key 缺失、粘贴不完整，或密钥已经撤销。
重新复制完整密钥；若密钥曾经公开，请撤销后创建新密钥。
404 / Not Found
baseURL 写成了完整操作路径，SDK 会再拼一次 /chat/completions。
baseURL 只填 https://llm.viafold.dev/v1，不要带具体操作路径。
Model not found
model 与当前目录里的模型 ID 不一致。
从 Viafold 当前模型目录复制完整模型 ID，保留大小写与连字符。
连接超时
当前网络无法稳定访问 llm.viafold.dev，或请求被本地代理拦截。
先查看 Viafold 运行状态，再检查本机网络、代理和防火墙设置。
05 / FAQ
常见问题
为什么把 OpenAI SDK 接到 Viafold？
现有 OpenAI 代码不用重写。改两行之后，同一个客户端可以按量调用 GPT 与 Claude，不必分别开户、分别充值。
baseURL 应该填什么？
填写 https://llm.viafold.dev/v1。SDK 会自己拼 /chat/completions 或 /responses；不要把完整操作路径写进 baseURL。
model 可以换成 Claude 吗？
可以。密钥不绑定单一模型，只要填写 Viafold 当前模型目录中存在的完整模型 ID 即可。
为什么配置后提示 401？
通常是密钥缺失、复制不完整或已被撤销。请使用创建时显示的完整 API Key；如果密钥曾经泄露，应撤销并重新创建。
READY
让现有 SDK 用上更多模型。
创建 API Key，把上面的两行配置填进去。下一轮调用， 就可以在 GPT 与 Claude 之间切换。