炬元 API 使用文档
覆盖站内操作、余额充值、API Key 创建、接口调用检测和模型可信度说明。
#第 1 章：炬元 API 站内操作
#1. 查看模型广场
打开：
https://www.yunquai.top/pricing模型广场用于查看当前站点支持的模型、供应商、接口端点和价格。当前模型广场需要登录后查看。 常见模型包括：
gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex
gpt-5.2
claude-opus-4-7
claude-opus-4-6
claude-sonnet-4-6
DeepSeek-V3.2
gpt-image-2查看模型时重点看：
模型名称：客户端里要填写的 model 名称
供应商：模型归属，例如 OpenAI、Anthropic、DeepSeek
端点：模型支持 chat、image、audio 等哪类接口
价格：输入、输出、缓存、动态计费等价格信息如果模型显示“动态计费”，说明该模型可能按上下文长度、缓存、请求特征等规则分段计费。比如 gpt-5.4、gpt-5.5 已配置超长上下文价格，超过指定上下文长度后会按超长上下文价格计算。
#2. 充值余额
进入控制台后打开：
https://www.yunquai.top/console/topup在充值页面可以看到：
账户统计
当前余额
历史消费
请求次数
充值数量
选择支付方式
选择充值额度
兑换码充值
账单现在充值页的余额按人民币口径展示，快捷充值额度也是人民币金额。页面会标注：
余额与人民币 1:1也就是说，选择或输入多少元充值额度，到账余额就按同等人民币余额计算；如果页面有折扣或首充体验价，实付金额会按页面显示的优惠金额计算。
常见操作流程：
1. 在“充值数量”里输入金额，或直接点击下方的快捷充值额度
2. 查看页面显示的“实付金额”
3. 选择支付宝、微信或页面上可用的其他支付方式
4. 在“充值确认”弹窗中确认充值数量、实付金额和支付方式
5. 跳转到支付页面完成付款示例：
选择充值额度：¥10.00
实付金额：¥10.00
到账余额：¥10.00如果当前账号符合首充体验活动，页面会额外显示“首充体验价”。这类活动以页面实时显示为准，例如页面显示支付 1 元到账 5 元余额时，按活动按钮发起支付即可。
支付完成后回到充值页，可以在顶部“当前余额”里查看是否到账，也可以点击右上角“账单”查看充值记录。
如果你手里有兑换码，也可以在“兑换码充值”里输入兑换码兑换额度。
#3. 创建 API Key
打开令牌页面：
https://www.yunquai.top/console/token点击：
添加令牌按页面填写：
名称：给这个 Key 起一个容易识别的名字
令牌分组：一般保持默认即可
过期时间：可以选择永不过期，也可以设置固定过期时间
额度：限制这个 Key 最多能用多少额度
无限额度：是否不单独限制这个 Key 的额度
模型限制列表：一般留空，表示支持所有可用模型推荐新手这样填：
名称：my-api-key
令牌分组：默认
过期时间：永不过期
额度：先填一个小额度测试
模型限制列表：留空说明：
令牌额度只是限制这个 Key 自己最多能消耗多少。
真正能不能调用，还会受账号总余额影响。
如果账号余额不足，即使 Key 还有额度，也可能无法继续调用。创建成功后，回到令牌列表，点击密钥旁边的复制按钮。
API Key 一般长这样：
sk-xxxxxxxxxxxxxxxx不要把 API Key 发到公开群、截图、文章或不可信网站里。
#4. 复制接口地址
炬元 API 的 OpenAI 兼容接口地址是：
https://www.yunquai.top/v1常用信息如下：
Base URL:
https://www.yunquai.top/v1
API Key:
sk-你的炬元API密钥
Chat Completions:
https://www.yunquai.top/v1/chat/completions
Models:
https://www.yunquai.top/v1/models大多数兼容 OpenAI 的客户端只需要填：
Base URL
API Key
Model例如：
Base URL: https://www.yunquai.top/v1
API Key: sk-你的炬元API密钥
Model: gpt-5.5#5. 先做一次简单调用测试
如果你会用 PowerShell，可以先测试模型列表：
$BASE="https://www.yunquai.top/v1"
$KEY="sk-你的炬元API密钥"
curl.exe -s "$BASE/models" `
-H "Authorization: Bearer $KEY"能返回模型列表，说明接口地址和 API Key 基本可用。
再测试普通对话：
$BASE="https://www.yunquai.top/v1"
$KEY="sk-你的炬元API密钥"
$body = @{
model = "gpt-5.5"
messages = @(
@{
role = "user"
content = "用一句话回复：炬元 API 接口测试成功"
}
)
} | ConvertTo-Json -Depth 10
curl.exe -s "$BASE/chat/completions" `
-H "Content-Type: application/json" `
-H "Authorization: Bearer $KEY" `
-d $body如果返回正常回答，说明账户余额、Key、模型和接口都能正常工作。
#6. 查看调用日志和扣费
测试后可以进入控制台查看日志：
控制台 -> 日志日志里通常可以看到：
请求时间
使用模型
调用是否成功
消耗额度
错误信息如果调用失败，先看日志里的错误原因。常见原因包括：
API Key 填错
Base URL 填错
模型名称填错
账户余额不足
令牌额度不足
客户端请求格式不兼容#7. 新手建议
第一次使用时，建议按这个顺序：
1. 注册并登录炬元 API
2. 先小额充值或使用兑换码
3. 创建一个小额度测试 Key
4. 打开模型广场，确认要使用的模型名称
5. 在客户端填写 Base URL、API Key、Model
6. 先发一条简单测试消息
7. 再查看日志确认扣费和返回是否正常不要一开始就把主 Key 填到很多软件里。建议为不同用途创建不同令牌，例如：
codex-key
claude-code-key
cherry-studio-key
test-key这样后续如果某个客户端不用了，可以单独禁用或删除对应令牌。
#第 2 章：API 中转站检测与可信度说明
这一章用于处理用户常见疑问：
炬元 API 是不是假模型？
模型是不是被替换了？
接口是不是套壳？
Claude / GPT 会不会被换成便宜模型？
为什么同一个模型，不同平台体验有差异？先说结论：API 中转站能做的是提供统一入口、路由、计费和稳定性管理。模型身份、输出风格和性能表现建议用实际检测结果判断，不建议只靠口头承诺，也不建议使用“100% 纯血”这类无法长期证明的宣传词。
#1. 最推荐的检测网站：Model Fingerprint
Model Fingerprint 是一个用于检测模型指纹相似度的工具，适合用户自己验证某个 endpoint 返回的模型表现是否接近目标模型。
它主要用于检测：
模型是否可能被替换
模型是否可能被降级
接口返回是否接近声明模型
模型输出特征是否与目标模型相似网站地址：
https://model-fingerprint.comGitHub 地址：
https://github.com/Mai8304/model-fingerprint说明：
它检测的是模型表现和指纹相似度，不等于法律或官方认证。
检测结果可以作为参考，但不建议把一次检测结果当成永久结论。
模型版本、上游路由、系统负载和服务状态变化，都可能影响结果。#2. Model Fingerprint 使用方法
打开网站后，按下面填写：
Base URL:
https://www.yunquai.top/v1
API Key:
sk-你的炬元API密钥
Model:
gpt-5.5
Fingerprint Model:
选择你要对比的目标模型然后点击：
Start Check
Run
开始检测检测完成后，重点看：
Match / Mismatch
Similarity
Nearest Candidate
Capability Consistency
Fingerprint Gap如果结果接近声明模型，可以截图保存，作为接口可用性和模型相似度的参考证明。
#3. 检测时不要使用主密钥
检测网站需要填写 API Key，所以不要使用大额度余额的主 Key。
建议专门创建一个测试 Key：
名称：test-key
额度：小额度
模型限制：只开放要测试的模型，或留空后测试完立刻删除
用途：专门用于检测检测完成后，可以回到：
https://www.yunquai.top/console/token然后禁用或删除这个测试 Key。
不要把这些 Key 发给别人：
管理员 Key
主力长期 Key
大额度 Key
全权限 Key
正在生产使用的 Key#4. 第二个检测工具：llm-verify
llm-verify 是一个开源检测项目，主要用于识别模型身份不一致、能力边界异常、模型冒充等情况。它会运行 identity、capability、fingerprint 等测试，并生成结构化风险报告。
GitHub 地址：
https://github.com/mintesnot-teshome/llm-verify适合：
高级用户
站长自查
需要本地部署检测流程的人它能辅助检测：
模型身份一致性
能力边界是否异常
指纹相似度
冒充或降级风险注意：这类工具需要一定技术基础。普通用户如果只是想简单验证，优先用 Model Fingerprint 和基础接口测试即可。
#5. 第三个工具：LLMetrics 性能检测
LLMetrics 主要不是检测“真假模型”，而是检测 API 服务性能。
它可以测：
首 Token 延迟 TTFT
Token 间隔 TBT
总响应耗时 E2E
流式输出稳定性
多轮对话性能GitHub 地址：
https://github.com/hyscale-lab/LLM-Benchmarking适合用来做：
站点测速报告
不同模型延迟对比
不同时间段稳定性对比
流式响应体验检测如果用户反馈“慢”，不要只看模型真假，也要看：
网络环境
模型本身推理速度
是否使用超长上下文
是否开启流式输出
上游服务是否繁忙
本次请求输出长度#6. 第四个工具：Julius 服务指纹检测
Julius 不是用来判断文本由哪个模型生成，而是用来识别服务端可能使用的 LLM 服务框架。
它可能识别：
Ollama
vLLM
LiteLLM
LocalAI
Hugging Face TGI
其他 AI 服务框架GitHub 地址：
https://github.com/praetorian-inc/julius这个工具更适合安全检测人员或站长自查。普通用户不建议随意扫描别人网站，只检测自己有权限检测的接口。
#7. 最基础的接口检测命令
如果不想使用第三方检测网站，也可以直接用 PowerShell 测试。
#7.1 测试模型列表
$BASE="https://www.yunquai.top/v1"
$KEY="sk-你的炬元API密钥"
curl.exe -s "$BASE/models" `
-H "Authorization: Bearer $KEY"#7.2 测试普通对话
$BASE="https://www.yunquai.top/v1"
$KEY="sk-你的炬元API密钥"
$body = @{
model = "gpt-5.5"
messages = @(
@{
role = "user"
content = "用一句话回复：炬元API接口检测成功"
}
)
} | ConvertTo-Json -Depth 10
curl.exe -s "$BASE/chat/completions" `
-H "Content-Type: application/json" `
-H "Authorization: Bearer $KEY" `
-d $body#7.3 测试流式输出
$BASE="https://www.yunquai.top/v1"
$KEY="sk-你的炬元API密钥"
$body = @{
model = "gpt-5.5"
stream = $true
messages = @(
@{
role = "user"
content = "请分三点介绍炬元API，每一点一句话。"
}
)
} | ConvertTo-Json -Depth 10
curl.exe -N "$BASE/chat/completions" `
-H "Content-Type: application/json" `
-H "Authorization: Bearer $KEY" `
-d $body如果内容是一段一段输出，说明流式基本正常。
#8. 对外展示时不要说“100%纯血”
建议对外这样说：
炬元 API 提供 OpenAI / Claude / Gemini 等模型的中转接入服务。
我们支持用户自行通过模型指纹检测、接口兼容检测、流式输出检测和延迟检测来验证可用性。
我们不建议用“100%纯血”这种无法被永久证明的口号，建议以实际检测结果、模型表现和稳定性为准。这样更专业，也更不容易被人抓话柄。
#9. 用户质疑时可以这样回复
你好，炬元 API 支持用户自行检测。
你可以用以下方式验证：
1. 使用 /v1/models 查看模型列表；
2. 使用 /v1/chat/completions 测试普通对话；
3. 使用 stream=true 测试流式输出；
4. 使用 model-fingerprint.com 做模型指纹检测；
5. 使用小额测试 Key，不要使用主密钥。
我们建议以实际检测结果为准，不靠口头宣传。#10. 检测结果截图建议
保存这些截图：
1. /v1/models 返回模型列表
2. /chat/completions 正常返回
3. stream=true 正常流式输出
4. Model Fingerprint 检测结果
5. 延迟测速结果
6. 用户后台余额扣费记录这些比单纯说“纯血”更有说服力。
#第 3 章：充值返利活动说明与操作
本章用于说明炬元 API 当前的邀请充值返利活动，包含活动规则、邀请方式、被邀请人操作方式、返利到账位置，以及常见问题说明。
活动比例：5%
活动方式：邀请他人注册并完成充值
返利对象：邀请人
返利口径：按被邀请人实际支付金额计算
返利去向：进入邀请收益，不直接进入主余额也就是说，用户通过你的邀请链接注册后，只要后续完成充值，你就可以获得该笔实际付款金额 5% 对应的返利。
#1. 活动规则说明
当前活动规则如下：
1. 用户 A 进入【钱包管理】复制专属邀请链接
2. 用户 B 通过邀请链接进入注册页并完成填写邀请链接注册
3. 用户 B 后续完成充值
4. 系统按用户 B 实际支付金额的 5% 计算返利
5. 返利发放给用户 A，进入用户 A 的邀请收益需要注意的是，返利不是按“充值面额”机械计算，而是按：
实际支付金额例如：
如果页面显示充值到账 10 元，但因为活动优惠或折扣，实际支付 8 元，
那么邀请返利按 8 元的 5% 计算，而不是按 10 元计算。#2. 邀请人如何获取邀请链接
邀请人登录炬元 API 后，进入钱包管理：
https://www.yunquai.top/console/topup在页面中的“邀请”或“邀请奖励”区域，可以看到自己的：
邀请链接
邀请人数
当前邀请收益
历史邀请收益操作方式：
1. 点击复制邀请链接
2. 将邀请链接发送给对方
3. 对方通过该链接进入注册页面邀请链接一般会长这样：
https://www.yunquai.top/register?aff=你的邀请码如果后续页面入口有调整，也可以理解为：
带 aff 参数的注册链接只要对方注册时绑定到了你的邀请码，后续充值就会进入返利链路。
#3. 被邀请人如何完成注册
被邀请人打开邀请链接后，会进入注册页面。
邀请链接（非必填）这表示：
这个字段不是必填，但如果想绑定邀请关系，最好确认已经带上或填上支持填写的内容包括：
完整邀请链接
纯邀请码
带 aff=xxxx 的注册链接例如：
https://www.yunquai.top/register?aff=ABCD
ABCD
aff=ABCD注册完成后，邀请关系就会被记录下来。
注意：
邀请关系的建立发生在注册阶段
返利的发放发生在后续充值成功之后也就是说，仅仅注册成功，还不会立刻产生充值返利。
#4. 返利什么时候到账
返利触发条件是：
被邀请用户完成有效充值到账时机一般是：
充值订单支付成功后
系统完成充值入账结算时
同步把邀请返利计入邀请人的邀请收益返利不会等很久人工审核，正常情况下是跟随充值成功一起结算。
如果被邀请人只是：
注册了但没有充值
下了订单但没有支付成功
支付失败
订单未完成那么邀请人不会获得这笔返利。
#5. 返利到账到哪里
当前返利到账位置不是主余额，而是：
邀请收益也可以理解为：
邀请专用额度
邀请奖励余额用户可以在充值页面的邀请区域查看：
当前可用邀请收益
历史邀请收益
邀请人数如果页面提供“划转邀请额度”或类似按钮，则说明可以把邀请收益再转入主余额使用。
这意味着：
返利先进入邀请收益池
再由用户自己决定是否划转到主余额#6. 返利计算示例
下面给几个常见例子：
#6.1 正常充值
被邀请用户实际支付：100 元
返利比例：5%
邀请人获得返利：5 元对应的邀请收益#6.2 折扣充值
页面充值面额：100 元
实际支付金额：80 元
返利比例：5%
邀请人获得返利：4 元对应的邀请收益#6.3 首充体验价
页面活动：1 元到账 5 元余额
被邀请用户实际支付：1 元
返利比例：5%
邀请人获得返利：按 1 元计算的返利这里要特别注意：
返利基于实付金额
不是基于到账面额
不是基于优惠前金额#7. 常见问题
#7.1 对方注册了，为什么我还没有返利？
因为：
注册本身不产生充值返利
必须等对方后续完成充值#7.2 对方充值了，返利按哪个金额算？
按：
实际支付金额不是按：
到账余额
活动优惠前金额
页面标价#7.3 返利会直接进我的主余额吗？
不会，当前规则是：
先进入邀请收益
再按页面可用功能决定是否划转#7.4 注册时没有点邀请链接，还能补吗？
如果注册页面还没提交，一般可以：
手动填写邀请链接或邀请码如果已经注册完成，通常就要以系统当时记录的邀请关系为准。
#7.5 一个用户充值多次，会不会多次返利？
只要这些充值都属于：
同一邀请关系下的有效成功充值就会按每笔实际成功支付分别计算返利。
#8. 新手使用建议
如果你是第一次使用这类活动，建议按下面顺序操作：
1. 先登录自己的炬元 API 账号
2. 到充值页复制自己的邀请链接
3. 把邀请链接发给对方
4. 提醒对方注册时确认邀请码已自动带入，或手动填写
5. 等对方完成充值
6. 回到充值页查看邀请收益是否增加
7. 如有需要，再按页面功能把邀请收益划转到主余额