常见问题
账户、安全、计费、兼容性、故障排查。遇到问题先看这里，90% 的问题能在 1 分钟内解决。
更新于 2026-04-17
账户与 Key
API Key 丢了能找回吗？
不能。Key 只在创建时明文显示一次，之后数据库里只存哈希。如果丢失，直接在控制台吊销旧 Key → 创建新 Key，两步即可。
一个账户能创建多少个 Key？
默认 20 个，超过可申请提额。建议按用途拆分：cursor-mac、claude-code-work、ci-prod 等便于审计和吊销。
怎样限制某个 Key 的消耗？
控制台 API Keys → 编辑 可为每个 Key 单独设置：
- 每日上限（USD）
- 每月上限（USD）
- 允许调用的模型白名单
超额自动暂停该 Key，不影响其他 Key。
账户能注销吗？
能。控制台 设置 → 账户安全 → 注销账户，软删除 30 天内可撤销；过后按 GDPR 流程物理删除。详见 隐私政策。
计费
怎么算钱？
按量计费 = (输入 tokens × 输入价 + 输出 tokens × 输出价) × 模型倍率。倍率在 0.3x–0.4x 之间，低于官方。详见 价格页。
首次充值多少合适？
最低 $1 起充。建议先 $2–10 测试接入，确认工具链跑通后再批量充值。
能开发票吗？
不支持开具中国增值税发票（普票 / 专票均不开）。如确有需要，可应请求提供海外形式发票（proforma invoice）；该形式发票非中国税务发票，不可用于境内增值税抵扣或报销入账。
余额退款规则？
- 充值余额：不支持无理由退款（含未消费部分）
- 已使用部分：不退款
- 被动退款：仅在法律法规要求或平台重大故障等特定情形下办理（详见 退款政策）
- 平台异常导致的损失：可申请赔付到账户余额（按公开规则人工审核）
兼容性
支持 OpenAI SDK 吗？
支持。所有 /v1/chat/completions、/v1/embeddings 等 OpenAI 端点完全兼容，改 base_url = "https://api.staging.cosmos-router.com/v1" 即可。
支持 Anthropic 官方 SDK 吗？
支持。anthropic Python / Node SDK 改两个环境变量就能跑：
export ANTHROPIC_BASE_URL="https://api.staging.cosmos-router.com"
export ANTHROPIC_API_KEY="sk-xxxxx"支持 function calling / tool use 吗？
支持。OpenAI 的 tools 参数和 Anthropic 的 tools 均透传上游，不做任何改写。
支持流式 / SSE 吗？
支持。stream: true 行为与官方完全一致。
支持 prompt cache 吗？
支持。OpenAI 自动缓存、Anthropic 显式 cache_control 均按官方费率计费（缓存命中 = 输入价的 10%–50%）。
故障排查
调用返回 401 Unauthorized
- 检查 Key 是否以
sk-开头（不是sk-ant-这种官方 Key） - 检查 Key 是否已被吊销（控制台 API Keys 页面看状态）
- 检查请求头格式：
Authorization: Bearer sk-xxxxx（注意Bearer后有空格） - 最常见的原因：复制到的是控制台上打码显示的串（形如
sk-abc····wxyz），它不是真实 Key，请用复制按钮重新获取 - 一条命令自查：
npx --prefer-online zetaapi@latest doctor --api-url=https://api.staging.cosmos-router.com --key=sk-你的Key（见接入自检）
调用返回 402 Insufficient Quota
账户余额不足或该 Key 已达每日/每月上限。前往控制台充值或调高上限。
调用返回 429 Rate Limit
- 默认限流 600 RPM / 300k TPM
- 客户端应指数退避重试（
Retry-After头给出秒数） - 高频场景在控制台申请提额
调用很慢或超时
- 检查 状态页（/status）看是否正在故障切换
- Claude / GPT 大模型首 token 延迟 1–3 秒属正常
- 如持续 > 10 秒，控制台 最近调用查看该请求的上游响应时间，可能是上游排队
- 完全连不上（不是慢，是没有响应）属于另一类问题，跑
npx --prefer-online zetaapi@latest doctor --api-url=https://api.staging.cosmos-router.com定位，见接入自检
响应内容和官方不一样
ZetaAPI 对请求和响应完全透传，不做 prompt 改写、不做结果过滤。如果你看到差异，绝大多数情况是：
- 模型版本不一致（
gpt-4o有多个 snapshot） - 温度 / top_p 等参数不同
- 随机性（固定
seed可复现）
如果仍然怀疑是中转问题，工单附上请求 ID（响应头 x-request-id）联系客服。
安全
我的 prompt 和响应会被记录吗？
- 元数据（模型名、token 数、耗时、状态码）用于计费和监控，保留 90 天
- prompt 和响应内容默认不记录；仅在你主动开启”调试日志”功能时记录 7 天
- 平台员工无权访问用户内容，审计日志公开
传输加密？
全链路 TLS 1.3，前到客户端、后到上游均强制 HTTPS。
如果我的 Key 泄露了？
立即在控制台 API Keys 页面吊销该 Key（即时生效，10 秒内全局失效）。平台会自动监控 GitHub 上暴露的 Key 并主动通知你。
还没找到答案？
- 翻 API Reference 看技术细节
- 看 Changelog 确认是否是最近变更
- 控制台右下角提工单，工作日 2 小时内响应