GPT / Claude 模型接入教程

第一次配置的话,照着这份教程做:先确认你拿到的是 API Key 还是充值码,再按自己的系统填写地址、Key 和模型名,最后发一句测试。

统一 API GPT 模型 Claude 模型 Windows macOS 推荐 gpt-5.5

第 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 请自己保存好,不要发给别人,也不要截图发到公开群。

第 2 步:确认你手里拿到的是什么

新用户包

如果你收到的是“新用户包”,里面会有一个 API Key。这个 Key 已经有额度,直接填进客户端就能用。

续费充值码

如果你收到的是充值码,先打开 https://www.toupiaoai.com/redeem,输入原来的 API Key 和充值码。兑换成功后,原来的 Key 继续使用。

复制 Key 时注意

复制完整 API Key,不要少复制开头或结尾。粘贴后检查前后没有空格、换行或中文标点。

先查一次余额

不确定 Key 有没有额度时,先打开查询余额页。能查到余额,再去配置客户端。

第 3 步:选择要填写的模型名

同一个 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 维护中 高质量复杂任务。 暂未稳定开放,恢复后会更新说明。

关于倍率:上面的倍率是当前值,会随养号成本、线路稳定性和活动调整。平台不定期会有降低倍率的活动。模型名会保持固定,线路变化由后台处理,用户不用反复修改配置。

第 4 步:Windows 上怎么填

下面按常见客户端写法说明。不同软件的字段名称可能略有不同,看到 Base URL、API URL、Endpoint、API Key、Model 这几类字段时,对应填写即可。

打开客户端设置

进入软件的 Settings / 设置,找到 API、Provider、Model Provider、模型供应商或自定义接口。

选择自定义接口

如果有 OpenAI Compatible、Custom OpenAI、自定义 OpenAI、自定义 API 这类选项,选择它。

填写 API 地址

Base URL / API URL / Endpoint 填 https://api.toupiaoai.com/v1。注意末尾有 /v1

填写 API Key

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

Windows PowerShell 测试命令

如果客户端还是连不上,可以先用下面命令测试。把第一行里的“你的 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

第 5 步:macOS 上怎么填

macOS 的客户端设置方式和 Windows 类似。字段名称可能不同,但本质上还是填 API 地址、API Key 和模型名。

打开客户端设置

进入 Settings / API / Provider / Model Provider,找到自定义接口或自定义模型供应商。

选择自定义接口

选择 OpenAI Compatible、Custom OpenAI 或自定义 API。

填写 API 地址

Base URL / API URL / Endpoint 填 https://api.toupiaoai.com/v1

填写 API Key

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

macOS 终端测试命令

把第一行里的“你的 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"}]}'

第 6 步:新用户和续费分别怎么用

新用户包

  • 如果你收到的是“新用户包”,里面的 API Key 已经包含额度。
  • 直接把 API Key 填进客户端即可使用,不需要再兑换充值码。
  • 可以先到查询余额页确认 API Key 余额。

老用户续费

  • 老用户续费会拿到充值码。
  • 打开 https://www.toupiaoai.com/redeem,输入原 API Key 和充值码。
  • 兑换成功后,原 API Key 余额增加,客户端配置不需要改。

第 7 步:独立测试接口是否可用

如果客户端一直连不上,先用下面的 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,就说明已经接通。

第 8 步:常见问题怎么处理

  • 401 / Invalid API key:API Key 填错、复制不完整,或填成了其他平台的 Key。
  • 404 / endpoint not found:Base URL 应为 https://api.toupiaoai.com/v1,不要漏掉 /v1
  • 模型不可用:确认模型名是否为当前开放模型,如 gpt-5.4gpt-5.5claude-sonnet-4-6claude-sonnet-4-6-maxclaude-sonnet-4-5;维护中的模型先不要填写。
  • 余额不足:到查询余额页确认余额;老用户续费后请先兑换充值码。
  • 客户端一直转圈:先关掉当前会话,新开一个会话再试;仍不行就用上面的 curl 命令测试。
  • 回复不是你选的模型风格:检查客户端模型名是否填对,尤其不要把模型名填到 API Key 输入框里。

代理和管理员排查时看这里

用户说“用不了”时,按下面顺序核对,通常很快能定位。

  • 先查 API Key 是否 active、余额是否足够。
  • 再查最近使用记录,看错误码是余额、认证、模型不可用还是线路异常。
  • 代理发卡时,新用户包直接给已含额度的 API Key;老用户续费用充值码。
  • 用户截图排查时,请遮住完整 API Key 和充值码。

新手接入路线图

按 1 到 8 的顺序做,正常就能接上。