注册并验证邮箱
填写用户名、密码和邮箱验证码。注册后登录控制台，后续充值、令牌和日志都在控制台管理。
易缘 API 使用指南
从注册充值，到
从注册充值，到
第一次成功调用
这份文档专门服务易缘 API 用户，覆盖模型选择、令牌创建、Cherry Studio / CC Switch 配置，以及 OpenAI、Claude、Gemini 和图片接口。
LIVE
POST/v1/chat/completions
curl https://zzz.tuyang.online/v1/chat/completions \ -H "Authorization: Bearer sk-••••" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-sol", "messages": [{ "role": "user", "content": "你好，请介绍一下自己" }] }'
POST/v1/responses
curl https://zzz.tuyang.online/v1/responses \ -H "Authorization: Bearer sk-••••" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-sol", "input": "用三句话介绍易缘 API" }'
POST/v1/messages
curl https://zzz.tuyang.online/v1/messages \ -H "x-api-key: sk-••••" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "你好"}] }'
POST/v1beta/models/{model}:generateContent
curl "https://zzz.tuyang.online/v1beta/models/gemini-3.5-flash:generateContent" \ -H "Authorization: Bearer sk-••••" \ -H "Content-Type: application/json" \ -d '{ "contents": [{"parts": [{"text": "你好"}]}] }'
OpenAI 客户端地址实时读取中
备用线路实时读取中
当前在售模型实时读取中
当前可用分组实时读取中
平台版本实时读取中
Quick start
5 分钟完成首次调用
按下面顺序操作，能避开最常见的“有 Key 但模型不可用”“地址多写一层 /v1”等问题。
充值或购买套餐
根据使用场景选择按量余额或平台当前提供的套餐。支付前确认登录的是正确账户。
选择模型分组并创建令牌
先在模型广场确认模型、价格和可用分组，再到控制台创建 API Key。令牌分组必须能访问目标模型。
配置客户端并测试
OpenAI 兼容客户端填写 https://zzz.tuyang.online/v1，粘贴令牌，添加模型名称后发起测试。
支付提醒：当前优先选择支付宝。若微信支付异常，请保存完整付款截图，并通过 QQ 群联系群主处理。
Endpoints
接口地址怎么填
“客户端 Base URL”和“完整请求地址”不是同一个概念。客户端通常填写带 /v1 的 Base URL；cURL 示例则填写完整端点。
https://zzz.tuyang.online/v1
适用于 Cherry Studio、CC Switch、OpenAI SDK 及多数兼容客户端。
https://daqianzaozhi.cn/v1
主域名网络异常时切换。不要在末尾重复添加第二个 /v1。
https://zzz.tuyang.online/v1/messages
用于支持 Anthropic Messages API 的客户端和程序。
https://zzz.tuyang.online/v1beta
请求路径还需要包含模型名和 :generateContent。
认证：所有调用都需要 API Key。通用写法为
Authorization: Bearer YOUR_API_KEY。不要把 Key 发到群里、截图里或公开代码仓库。Clients
常用客户端配置
客户端菜单名称可能随版本略有不同，但核心只有三项：提供商类型、API 地址、API Key。
Cherry Studio
适合日常聊天、图片理解和多模型切换。
- 添加“OpenAI 兼容”提供商。
- API 地址填
https://zzz.tuyang.online/v1。 - 粘贴令牌，添加模型广场中的完整模型名。
- 点击连接测试，成功后保存。
CC Switch
适合管理不同模型供应商和开发工具配置。
- 新建自定义或 OpenAI 兼容供应商。
- Base URL 填
https://zzz.tuyang.online/v1。 - 填写 API Key 和目标模型名。
- 若模型不通，优先检查令牌分组。
其他 OpenAI 兼容客户端
AionUI、DeepChat、Lobe Chat、OpenCat 等遵循同样逻辑。
- Provider 选择 OpenAI 或 OpenAI Compatible。
- Base URL 使用本站
/v1地址。 - 模型名必须与模型广场完全一致。
- 不要同时在地址和客户端里重复拼接
/v1。
Python / Node.js 开发
官方 OpenAI SDK 通常只需替换 Key 和 Base URL。
- Key 放在服务端环境变量中。
- Base URL 为
https://zzz.tuyang.online/v1。 - 先用非流式请求验证，再开启 stream。
- 生产环境设置超时、重试和日志脱敏。
Models & groups
模型、分组与实时价格
模型和价格会随上游调整，因此文档不维护容易过期的静态长表。下面的数据会从主站模型广场实时读取，最终价格以模型广场和控制台显示为准。
—全部模型
—OpenAI 兼容
—Responses
—Anthropic
—Gemini
当前可用分组
实时读取中
选择原则：同一模型可能在多个分组可用，价格、并发、稳定性或套餐规则不同。创建令牌时选择的分组必须包含目标模型；不确定时先到模型广场打开模型详情，查看可用分组与计费方式。
打开实时模型广场 →
API protocols
本站支持的 API 协议
普通客户端优先使用 OpenAI 兼容模式；需要厂商原生特性时，再选择 Responses、Anthropic 或 Gemini 协议。
OpenAI Chat
兼容范围最广，适合聊天、代码和多数第三方客户端。
/v1/chat/completions
OpenAI Responses
适合支持 Responses API 的新式客户端和开发流程。
/v1/responses
Anthropic Messages
使用 Claude 原生消息结构和 Anthropic 请求头。
/v1/messages
Gemini generateContent
使用 Gemini 原生 contents / parts 请求结构。
/v1beta/models/{model}:generateContent
图片生成
使用支持图片生成的模型，根据模型能力设置尺寸等参数。
/v1/images/generations
可复制请求示例
curl https://zzz.tuyang.online/v1/chat/completions \
-H "Authorization: Bearer $YIYUAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'curl https://zzz.tuyang.online/v1/responses \
-H "Authorization: Bearer $YIYUAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"input": "用三句话介绍易缘 API"
}'curl https://zzz.tuyang.online/v1/messages \
-H "x-api-key: $YIYUAN_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'curl "https://zzz.tuyang.online/v1beta/models/gemini-3.5-flash:generateContent" \
-H "Authorization: Bearer $YIYUAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "你好"}]}]
}'curl https://zzz.tuyang.online/v1/images/generations \
-H "Authorization: Bearer $YIYUAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-1",
"prompt": "一只坐在月球上的橘猫",
"size": "1024x1024"
}'Billing & usage
计费、余额与调用日志
费用取决于模型、分组和计费方式。部分模型按 Token 计费，部分图片或特殊能力可能按次计费。
先看模型详情
在模型广场确认输入价、输出价、按次价格、可用分组和接口类型。
再选令牌分组
分组决定可访问模型及实际计费倍率。模型名称正确但分组不支持时，请求仍会失败。
通过日志核对
调用后在控制台查看时间、模型、Token 用量、扣费和错误信息，排查时不要只看客户端提示。
保护账户余额
给令牌设置合理额度，定期更换泄露风险较高的 Key，不要把无限额度 Key 放进前端应用。
模型、分组和价格以主站实时页面为准。文档中的示例模型会自动选择当前对应协议的可用模型，但实际访问权限仍取决于你的令牌分组。
Troubleshooting
常见报错怎么处理
先在控制台查看调用日志，再按状态码定位。不要连续盲目重试，以免重复消耗额度。
认证失败
检查 Key 是否完整、是否已删除或过期；请求头必须包含 Bearer 和一个空格。
无权访问模型
令牌分组没有目标模型，或令牌权限受限。到模型广场核对可用分组。
路径或模型不存在
检查是否重复添加 /v1，并确认模型名称与模型广场完全一致。
频率或额度限制
降低并发，稍后重试；同时检查账户余额、令牌额度和模型 RPM / TPM 限制。
上游或网络异常
短暂等待后重试，必要时切换备用地址。持续发生时记录时间和请求 ID 联系售后。
支付未到账
保留完整付款截图、支付时间和账户信息，通过 QQ 群联系群主，切勿重复付款。
Announcements
平台公告
下方内容会与主站公告同步。套餐、支付和模型变化优先以主站控制台及最新公告为准。
支付提醒
优先选择支付宝。微信支付如出现异常，请保留完整截图并联系群主处理。
易缘 API 交流群
QQ群：1043186824。可咨询账户、充值、额度、模型和接口问题。
Support
联系售后前准备这些信息
信息越完整，问题处理越快。请隐藏 API Key、密码和付款敏感信息。
账户与时间
提供用户名或注册邮箱、问题发生的准确时间，并说明是充值还是调用问题。
模型与接口
提供模型名称、使用的主/备用地址、客户端名称和接口类型。
错误与日志
提供完整错误信息、HTTP 状态码和控制台日志中的请求记录，Key 必须打码。
支付截图
支付异常请提供完整支付截图和支付时间，不要只截局部，也不要重复付款。
官方交流群：QQ群
1043186824。群内不要发送完整 API Key、登录密码或其他账户凭据。