先准备三样东西。
一把 API 密钥
前往API 密钥创建令牌。先给测试令牌设置小额度、有效期和必要的模型范围。密钥只交给你信任的客户端。
一个实际在售的模型 ID
从模型与价格复制完整模型 ID,保留大小写。展示名称不是接口 ID;未列出的名称不要填写。
地址,只差一个 /v1。
不同工具会自动拼接不同的路径。不要照着一个工具的设置,套到所有客户端。
https://yaoyaozzz.com/v1https://yaoyaozzz.com如果遇到 404,先看完整请求路径。正确的对话路径是 /v1/chat/completions,不是 /v1/v1/chat/completions。有些工具默认附加 /v1,请按该工具的说明填写。
发出第一条请求。
下面是可修改的接入示例,不会在本页执行。请用你的环境变量提供令牌,并把 MODEL_ID 换成价格页里的真实模型 ID。
curl https://yaoyaozzz.com/v1/chat/completions \
-H "Authorization: Bearer $YAO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "你好,请用一句话介绍你自己。"}],
"stream": false
}'Windows PowerShell 中请使用 curl.exe,不要使用它的 curl 别名。上方示例使用 Bash 的换行符与环境变量写法。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["YAO_API_KEY"],
base_url="https://yaoyaozzz.com/v1",
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[{"role": "user", "content": "你好。"}],
stream=False,
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.YAO_API_KEY,
baseURL: "https://yaoyaozzz.com/v1",
});
const response = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "你好。" }],
stream: false,
});
console.log(response.choices[0].message.content);在熟悉的工具里,继续创作。
Cherry Studio
添加 OpenAI 兼容服务商,API 地址填写 https://yaoyaozzz.com。填入 API 密钥,添加价格页上的模型 ID,再检查一次连接。不要把展示名称当作模型 ID。
Claude Code
服务域名填写 https://yaoyaozzz.com。使用客户端的官方环境变量配置方式,并选择站内实际支持的 Anthropic 兼容模型。工具调用、上下文长度及扩展特性依赖所选模型和渠道,不保证所有模型都适用。
export ANTHROPIC_BASE_URL="https://yaoyaozzz.com" export ANTHROPIC_AUTH_TOKEN="$YAO_API_KEY"
其他 OpenAI 兼容客户端
通常填写带 /v1 的地址。若工具自己附加 /v1,则只填写域名。可以先在在线调试确认模型,再排查客户端配置。
兼容,不代表每条渠道完全相同。
| 协议 | 路径 | 需要留意 |
|---|---|---|
| OpenAI 兼容对话 | /v1/chat/completions | 基础接入首选。流式与工具能力以模型为准。 |
| 模型目录 | /v1/models | 令牌可用模型可能受分组与额度限制。 |
| Anthropic | /v1/messages | 选择支持相应协议的模型与渠道。 |
| Gemini 原生 | generateContent | 使用相应客户端的原生路径与格式。 |
| OpenAI Responses | /v1/responses | 依赖渠道配置。请显式提供 stream 字段。 |
本站提供接口转发,不承诺固定响应时间,不提供绘图、语音或 Embeddings 专用接口。价格、模型和渠道支持可能调整,以控制台与实际请求结果为准。
让排查,少一点猜测。
401 / 403检查密钥是否完整、过期或被禁用,以及令牌的模型范围和账号权限。不要用账号登录密码代替 API 密钥。
404检查服务地址与协议路径,尤其是重复的 /v1。确认所用模型 ID 在价格页可见。
429可能是并发、请求速率或渠道容量限制。减少并发,等待后重试;不要无限快速重试。
5xx / 超时可能是网关或合作节点暂时异常。先检查使用日志,确认调用和扣费记录,再决定是否重试,避免重复扣费。
余额 / 模型错误检查钱包余额、令牌限额、完整模型 ID 和分组。价格页可见,不代表你的令牌一定有权限调用。
联系客服时,提供模型 ID、请求时间、HTTP 状态和脱敏后的错误信息。不要附完整密钥、密码或对话正文。
密钥是钥匙,不是示例文字。
- 不要把 API 密钥放进公开网页、仓库、截图或客户端分享配置。
- 通过环境变量或可信的密钥管理方式使用令牌。服务端令牌不要暴露给浏览器。
- 测试完及时禁用不再需要的令牌。发现泄露,立即到控制台撤销并重新创建。
- 请求会转发到合作节点。不要提交不愿离开本机的敏感内容。
第一步很小,下一步很亮。
去工作台创建一把受限的测试密钥。