跳到指南正文
YOUR FIRST CONNECTION

从一个好想法,
到第一次调用。

不用先懂整座工作台。准备好账号、密钥和模型 ID,
把熟悉的工具,连接到你的下一片可能。

先准备三样东西。

01

账号与可用额度

注册账号后,在钱包检查额度。需要充值时,通过官方店铺获取兑换码,再回到钱包兑换。本站不在这页收款。

02

一把 API 密钥

前往API 密钥创建令牌。先给测试令牌设置小额度、有效期和必要的模型范围。密钥只交给你信任的客户端。

03

一个实际在售的模型 ID

从模型与价格复制完整模型 ID,保留大小写。展示名称不是接口 ID;未列出的名称不要填写。

地址,只差一个 /v1。

不同工具会自动拼接不同的路径。不要照着一个工具的设置,套到所有客户端。

OpenAI SDK / OpenAI 兼容 Base URLhttps://yaoyaozzz.com/v1
Cherry Studio / Claude Code 的服务域名https://yaoyaozzz.com

如果遇到 404,先看完整请求路径。正确的对话路径是 /v1/chat/completions,不是 /v1/v1/chat/completions。有些工具默认附加 /v1,请按该工具的说明填写。

发出第一条请求。

下面是可修改的接入示例,不会在本页执行。请用你的环境变量提供令牌,并把 MODEL_ID 换成价格页里的真实模型 ID。

cURL / 终端
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 的换行符与环境变量写法。

Python / OpenAI SDK
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)
Node.js / OpenAI SDK
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 密钥放进公开网页、仓库、截图或客户端分享配置。
  • 通过环境变量或可信的密钥管理方式使用令牌。服务端令牌不要暴露给浏览器。
  • 测试完及时禁用不再需要的令牌。发现泄露,立即到控制台撤销并重新创建。
  • 请求会转发到合作节点。不要提交不愿离开本机的敏感内容。
READY WHEN YOU ARE

第一步很小,下一步很亮。

去工作台创建一把受限的测试密钥。

创建 API 密钥 ↗