常见问题

接入

TokenJoy 是什么？

TokenJoy 是一个大模型 API 接入平台，为独立开发者与 AI 团队提供 Claude、GPT 等模型的 API。接口兼容 Anthropic 与 OpenAI 官方格式，一把 API Key 就能调用多家厂商的模型，按实际 token 用量计费。 相关：Claude API 中转

支持哪些模型？

支持 Anthropic Claude、OpenAI GPT、Google Gemini、DeepSeek 等厂商的文本、图像和语音模型。完整列表和每个模型的价格见模型页，也可以用你的 Key 请求 GET /v1/models 获取。 相关：模型列表与价格

支持 OpenAI 兼容接口吗？

支持。OpenAI 格式提供 /v1/chat/completions、/v1/responses 和 /v1/embeddings，Anthropic 格式提供 /v1/messages。Claude、Gemini 等其他厂商的模型也可以用 OpenAI 的 Chat Completions 格式调用。 相关：使用 OpenAI API、使用 Anthropic API

接入需要改代码吗？

不需要。官方 SDK 和兼容软件只要把 Base URL 换成 TokenJoy 的 API 地址、把 API Key 换成在控制台创建的 Key，其余代码不用动；换模型只改模型名。 相关：首次调用 API

能用在 Claude Code、Cursor 等工具里吗？

可以。Claude Code、Codex、Cursor、Cline、OpenCode、Cherry Studio 等工具都有对应的配置教程，部分工具支持一行命令自动配置。 相关：接入 Claude Code、其他 Agent

在国内可以直接访问吗？需要 VPN 吗？

可以直接访问，不需要 VPN。请求由 TokenJoy 的网关经海外专用线路转发到官方接口，你不需要自己注册或维护海外账号。

计费

怎么计费？

按实际 token 用量计费：扣费 = 实际 token 数 × 官方单价 × 该模型的价格倍率。输入、输出、缓存读取、缓存写入分别计价，每个模型的官方价和实付价都在模型页公开标出。余额以美元计，控制台可以切换成人民币显示。 相关：一次请求扣多少钱、Claude API 成本怎么算

请求失败会扣费吗？

不会。失败的请求不扣费，扣费以网关记录的实际 token 用量为准。每次请求是否成功、用了多少 token、扣了多少钱，都能在控制台的请求记录里逐条核对。

有月费或最低消费吗？

没有。按量付费用多少扣多少；也可以按需购买额度包或订阅，多个套餐的额度叠加在同一份余额里。 相关：套餐与价格

余额有有效期吗？

没有。充值包、多期套餐已发放的部分和兑换的卡密，都没有有效期，账号存续期间一直可用。

在哪里查看用量和扣费明细？

控制台「概览」的请求记录列出近 30 天的每一次请求，包括时间、模型、成功与否、用时、输入和输出 token 和花费；用量页按天、按 Key、按模型汇总；流水记录每一次余额变动。

可以退款吗？

余额充值包、多期套餐或 Team 席位购买后 7 天内、所得余额尚未使用的，可以申请全额退款；首次订阅另有 7 天保障。已消耗的余额不予退款，完整规则见服务条款第 7 条。 相关：服务条款

稳定性

API 稳定吗？

访问 Anthropic、OpenAI、Google 走海外专用线路，长输出不会中途断流；后台多账号负载均衡，某个账号出问题时请求会转到其他账号上。网关每分钟用真实请求探测一次线路，发现异常自动切换，探测结果在服务状态页公开。 相关：服务状态、更高的可用性

有并发或请求数限制吗？

不对单把 Key 设置固定的请求数或并发上限，也没有 5 小时限额。遇到上游限流或瞬时过载时接口返回 HTTP 429，稍等后按指数退避重试即可。 相关：限速与隔离、错误码

调用的是官方模型吗？

是。请求直达官方接口，调用的就是你指定的官方模型，模型名和官方一致。

隐私与安全

会保存我的请求内容吗？

默认情况下，网关会保存 API 请求和模型回复内容，供你在控制台的请求记录里排查问题，只有你本人能打开，保存期满后按天自动删除。开启隐私模式后，网关不再保存任何请求和回复内容，只记录请求是否成功。 相关：隐私政策

会用我的数据训练模型吗？

不会。我们不会用你的请求内容训练 AI 模型，也不会把你的信息用于广告投放。请求内容会转发给相应的模型提供方以生成回复，受其各自隐私政策约束。

API Key 泄露了怎么办？

立即在控制台重置这把 Key，旧 Key 随即失效。停用或重置一把 Key 只影响它自己，建议按设备或项目分开创建 Key，便于区分用量和单独停用。