接入文档

三步接入，兼容所有 OpenAI 客户端。

第一步：记下 Base URL

这是你所有请求的根地址。客户端里填接口地址时，就填它。

Base URL https://ltzy.zhuafs.com/v1

请务必填写这个地址，不要随意改动，也不要在末尾多加 /v1。多数「连不上」都是地址填错。

第二步：创建 API 密钥

登录后到控制台创建密钥，复制 sk- 开头的字符串，它就是你调用接口的钥匙。

去创建密钥

第三步：发起第一次调用

把下面命令里的 sk-your-key 换成你的密钥，即可在终端测试。

第三步：发起第一次调用

curl https://ltzy.zhuafs.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

常见客户端配置

客户端	配置要点
ChatGPT-Next-Web	设置 → 自定义接口：填入上方 Base URL；API Key 填你的密钥。
LobeChat	设置 → 语言模型 → OpenAI：接口代理地址填上方 Base URL。
Cherry Studio	模型服务 → 添加 OpenAI 提供商：API 地址填 Base URL，再填密钥。
Cursor	Settings → Models → OpenAI API Key + Override Base URL：填上方 Base URL。
Cline（VS Code）	API Provider 选 OpenAI Compatible；Base URL 填上方地址；模型 ID 手动输入。
Dify	模型供应商 → OpenAI：API Base 填上方 Base URL，再填密钥。
Open WebUI	设置 → 连接 → OpenAI API：Base URL 填上方地址。
沉浸式翻译	AI 服务 → OpenAI：自定义接口地址填 Base URL，填密钥与模型。

错误码排查

状态码	原因与处理
`401`	密钥缺失或无效。请检查密钥是否填写完整、是否被删除。
`402`	余额不足或密钥额度用尽。请充值，或使用不限额度的密钥。
`403`	该密钥不允许调用此模型，或账号被禁用。
`404`	地址填写错误。请确认地址以 /v1/chat/completions 结尾。
`413`	请求体过大。请减少输入内容。
`429`	触发限流或上游繁忙。请稍等后重试。
`500 / 502 / 503`	上游或网关异常。请重试；持续出现请查看「服务状态」页。
`超时`	上游响应较慢。可尝试更小的请求或更换模型。