常见问题
接入与兼容性
TokOne 和 OpenAI / Anthropic / Gemini 是什么关系?
TokOne 是一个 API 网关,对外提供与这三家兼容的接口。你用 TokOne 的API Key,就能通过统一入口调用它们的兼容端点。
我需要改代码吗?
基本不用。把现有 SDK 的 Base URL 指向 TokOne(如 https://api.tokone.ai),API Key 换成 sk- 密钥即可。
支持流式输出吗?
支持。所有推理端点都支持 SSE 流式,请求体加 "stream": true 即可;/v1/responses 端点还额外支持 WebSocket 流式。
账号与充值
怎么开始?
注册账号 → 在控制台创建 API Key → 确保账户有余额 → 按快速接入发起第一次调用。
余额不足会怎样?
余额不足时,新的计费请求会返回 HTTP 402。充值后即可恢复。
API Key 与安全
API Key 长什么样?
默认以 sk- 开头(具体前缀由部署方配置)。
可以用 URL 参数传 Key 吗?
不可以。 出于安全考虑,通过查询参数(?key= / ?api_key=)传 Key 的请求会被拒绝(HTTP 400)。请使用请求头:Authorization: Bearer、x-api-key 或 x-goog-api-key。
Key 泄露了怎么办?
立即在控制台禁用/重置该 Key,并排查使用记录。
计费与限制
怎么计费?
按实际消耗的 Token 计费,输入/输出分别定价,再叠加分组倍率与服务等级系数。详见计费规则。
不同账号价格一样吗?
不一定。每个分组可设置不同的费率倍率,管理员还能对个别用户做覆盖,实际单价以你所在分组配置为准。
遇到 429 怎么办?
说明触发了限流,降低请求频率或稍后重试即可。
服务与支持
调用返回 404 / 模型不可用?
先确认请求路径是否正确(如 /v1/chat/completions),再用 GET /v1/models 确认该模型当前是否可用。