常见问题

通用问题

TokenCode 和直接调用 OpenAI/Claude API 有什么区别？

TokenCode 是一个 AI API 聚合网关。通过 TokenCode，你可以：

用一个 API Key 访问 40+ 供应商的所有模型
自动协议转换，无需为不同模型适配不同 SDK
享受智能路由、故障转移和负载均衡
统一的计费和管理面板

直接调用每个供应商需要分别注册账号、管理多个 API Key、适配不同协议。

协议自动转换是怎么工作的？

当你通过 OpenAI 协议调用 Claude 模型时，TokenCode 会：

接收 OpenAI 格式的请求
将其转换为 Anthropic 原生格式发送给上游
将 Anthropic 原生响应转换为 OpenAI 格式返回给你

反向同理——通过 Anthropic 协议调用 OpenAI 模型也会自动转换。整个过程对客户端完全透明。

支持哪些模型？

支持 OpenAI、Anthropic、Google、AWS Bedrock、Azure、DeepSeek、Mistral、Meta 等 40+ 供应商的模型。完整模型列表请查看首页，或通过 GET /v1/models 接口查询。

账户与计费

如何充值？

登录 Portal，在账户页面选择充值金额。支持预付费模式，Token 消耗从余额中实时扣除。

余额不足会怎样？

当余额耗尽时，API 请求将返回 429 Too Many Requests 错误。请及时充值以恢复服务。

如何查看用量？

登录 Portal，在用量页面可以查看按日期、模型维度的 Token 消耗和费用明细。

连接与配置

API Base URL 是什么？

OpenAI 协议：https://tokencode.dev/v1
Anthropic 协议：https://tokencode.dev
Gemini 协议：https://tokencode.dev

为什么 OpenAI 协议的 Base URL 有 /v1 而 Anthropic 没有？

这是各协议的惯例：

OpenAI SDK 默认在 base URL 后拼接 /chat/completions 等路径，所以 base URL 需要包含 /v1
Anthropic SDK 默认在 base URL 后拼接 /v1/messages，所以 base URL 不应包含 /v1

支持流式响应吗？

支持。所有协议的端点都支持流式输出，设置 stream: true 即可。

模型与功能

可以通过 Anthropic 协议调用 OpenAI 模型吗？

可以。TokenCode 的协议自动转换功能支持跨协议调用任意模型。通过 Anthropic 协议调用 GPT-4o 时，请求和响应会自动适配。

Function Calling 支持吗？

支持。Function Calling / Tool Use 在协议转换中会被正确映射。

支持图片输入吗？

支持。OpenAI、Anthropic、Gemini 协议均支持图片输入（Vision），具体格式请参考各协议的 API 参考文档。

Extended Thinking 支持吗？

Extended Thinking 是 Claude 模型的特有功能，仅在 Anthropic 协议下调用 Claude 模型时可用。通过协议转换调用非 Claude 模型时不支持此功能。

错误排查

返回 401 错误

检查 API Key 是否正确
确认 Header 格式：Authorization: Bearer sk-xxx 或 x-api-key: sk-xxx
确认 API Key 未过期

返回 429 错误

余额不足：在 Portal 中充值
速率限制：等待一段时间后重试

返回 404 错误

检查请求路径是否正确
确认模型名称拼写正确
确认 Base URL 配置正确（OpenAI 协议需包含 /v1）

响应格式异常

确认你使用的协议端点与客户端匹配
检查模型是否支持你使用的功能
尝试用 curl 直接请求验证

连接超时

检查网络是否能访问 tokencode.dev
确认 Base URL 拼写正确
如果使用代理，检查代理配置