第 1 步:先记住这几个入口
| API 地址 | https://api.toupiaoai.com/v1 |
|---|---|
| 查询余额 | https://www.toupiaoai.com/query |
| 充值兑换 | https://www.toupiaoai.com/redeem |
| 使用教程 | https://www.toupiaoai.com/docs |
API 地址只在客户端设置里填写一次。API Key 请自己保存好,不要发给别人,也不要截图发到公开群。
第一次配置的话,照着这份教程做:先确认你拿到的是 API Key 还是充值码,再按自己的系统填写地址、Key 和模型名,最后发一句测试。
| API 地址 | https://api.toupiaoai.com/v1 |
|---|---|
| 查询余额 | https://www.toupiaoai.com/query |
| 充值兑换 | https://www.toupiaoai.com/redeem |
| 使用教程 | https://www.toupiaoai.com/docs |
API 地址只在客户端设置里填写一次。API Key 请自己保存好,不要发给别人,也不要截图发到公开群。
如果你收到的是“新用户包”,里面会有一个 API Key。这个 Key 已经有额度,直接填进客户端就能用。
如果你收到的是充值码,先打开 https://www.toupiaoai.com/redeem,输入原来的 API Key 和充值码。兑换成功后,原来的 Key 继续使用。
复制完整 API Key,不要少复制开头或结尾。粘贴后检查前后没有空格、换行或中文标点。
不确定 Key 有没有额度时,先打开查询余额页。能查到余额,再去配置客户端。
同一个 API Key 可以用 GPT,也可以用 Claude。区别只在模型名,地址和 Key 不用换。
| 模型名 | 当前消耗倍率 | 适合场景 | 说明 |
|---|---|---|---|
gpt-5.5 |
3x | 复杂代码、推理、长任务。 | GPT 系列推荐默认模型。 |
gpt-5.4 |
3x | 日常问答、轻量代码、速度优先。 | GPT 系列常规模型。 |
claude-sonnet-4-6 |
1x | Claude Sonnet 常规任务。 | 低倍稳定线路,日常优先用这个。 |
claude-sonnet-4-5 |
1x | Claude Sonnet 兼容任务。 | 作为 Sonnet 兼容模型。 |
claude-sonnet-4-6-max |
13x | Claude 满血高倍线路。 | 消耗很高,只在需要满血 CCMax 时使用。 |
claude-opus-4-7 |
维护中 | 高质量复杂任务。 | 暂未稳定开放,恢复后会更新说明。 |
关于倍率:上面的倍率是当前值,会随养号成本、线路稳定性和活动调整。平台不定期会有降低倍率的活动。模型名会保持固定,线路变化由后台处理,用户不用反复修改配置。
下面按常见客户端写法说明。不同软件的字段名称可能略有不同,看到 Base URL、API URL、Endpoint、API Key、Model 这几类字段时,对应填写即可。
进入软件的 Settings / 设置,找到 API、Provider、Model Provider、模型供应商或自定义接口。
如果有 OpenAI Compatible、Custom OpenAI、自定义 OpenAI、自定义 API 这类选项,选择它。
Base URL / API URL / Endpoint 填 https://api.toupiaoai.com/v1。注意末尾有 /v1。
API Key / Token / 密钥 填你收到的完整 Key。不要填充值码,充值码只用于续费兑换。
Model / Model ID / 模型名称 填 gpt-5.5。想用 Claude 时,再换成 Claude 模型名。
保存后新开一个会话。如果原来的聊天窗口还在报错,先关掉它,再重新打开。
输入 请只回复 ok。如果回复 ok,说明配置已经成功。
Base URL: https://api.toupiaoai.com/v1
API Key: 你的 API Key
Model: gpt-5.5
如果客户端还是连不上,可以先用下面命令测试。把第一行里的“你的 API Key”替换成完整 Key 后再运行。
$env:API_KEY = "你的 API Key"
$body = @{
model = "gpt-5.5"
messages = @(@{ role = "user"; content = "请只回复 ok" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://api.toupiaoai.com/v1/chat/completions" -Method Post -Headers @{ Authorization = "Bearer $env:API_KEY"; "Content-Type" = "application/json" } -Body $body
macOS 的客户端设置方式和 Windows 类似。字段名称可能不同,但本质上还是填 API 地址、API Key 和模型名。
进入 Settings / API / Provider / Model Provider,找到自定义接口或自定义模型供应商。
选择 OpenAI Compatible、Custom OpenAI 或自定义 API。
Base URL / API URL / Endpoint 填 https://api.toupiaoai.com/v1。
API Key 填完整 Key。粘贴后确认没有多余空格。
推荐先填 gpt-5.5 测试。需要 Claude 时,可以填 claude-sonnet-4-6。
新开一个会话,发送 请只回复 ok。能回复就说明接通。
Base URL: https://api.toupiaoai.com/v1
API Key: 你的 API Key
Model: gpt-5.5
把第一行里的“你的 API Key”替换成完整 Key。能返回内容,就说明地址和 Key 是通的。
export API_KEY="你的 API Key"
curl https://api.toupiaoai.com/v1/chat/completions -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"请只回复 ok"}]}'
https://www.toupiaoai.com/redeem,输入原 API Key 和充值码。如果客户端一直连不上,先用下面的 curl 测试。能返回内容,说明 API 地址和 Key 没问题;再回去检查客户端里的模型名和保存状态。
curl https://api.toupiaoai.com/v1/chat/completions -H "Authorization: Bearer 你的 API Key" -H "Content-Type: application/json" -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"请只回复 ok"}]}'
正常情况下会返回一段 JSON,里面会有回复内容。只要回复里出现 ok,就说明已经接通。
https://api.toupiaoai.com/v1,不要漏掉 /v1。gpt-5.4、gpt-5.5、claude-sonnet-4-6、claude-sonnet-4-6-max、claude-sonnet-4-5;维护中的模型先不要填写。用户说“用不了”时,按下面顺序核对,通常很快能定位。
按 1 到 8 的顺序做,正常就能接上。