认证与计费
kukuai.fyi 使用 Bearer Token 鉴权。计费、限速与 SLA 等数值由控制台与后端配置动态下发，本页面不固化具体数字。
kukuai.fyi 使用 Bearer Token 鉴权。计费、限速与 SLA 等数值由控制台与后端配置动态下发，本页面不固化具体数字。
所有请求都使用 HTTP Authorization: Bearer ``<API_KEY>```。 API Key 以 sk-` 开头，长度 40+，请视为生产 secret 妥善保管。
通用 Header
除鉴权外，kukuai.fyi 还认识下面这些可选 Header：
http
# 通用 HTTP Header
Authorization: Bearer $KUKUAI_API_KEY
Content-Type: application/json
# 可选：透传业务用户 ID，用于审计与风控
X-Kukuai-User: usr_abc123
# 可选：幂等键，重试同一逻辑请求时复用
Idempotency-Key: 9c4a52a4-2fdd-4b49-9e72-1a7b7b4e3a01密钥安全
- 仅在服务端使用：浏览器、移动端、桌面客户端都无法可靠保管 secret， 请通过自己的 server / Edge route 转发。
- 不要写进代码仓库：使用环境变量、Vault、云厂商 secret manager。
- 最小权限：在控制台为每个项目 / 每个环境创建独立 Key， 只授予所需模型权限。
- 泄露立刻撤销：在控制台「API Keys」页面一键 revoke， 受影响的请求会立刻返回
401 invalid_api_key。
密钥轮换
推荐的零停机轮换流程：
bash
# 1. 在控制台创建新 Key（标注用途，例如 web-prod-2026Q2）
# 2. 滚动部署：先把新 Key 发到环境变量 KUKUAI_API_KEY_NEXT
# 3. 应用读取顺序：优先 NEXT，回退老 Key（双 Key 阶段）
# 4. 监控指标全部稳定后，把新 Key 改回 KUKUAI_API_KEY，删除老 Key用量与计费
AI 电网与 Token 电力
很多用户从其他中转站迁移过来时，会习惯先问：倍率多少、1 块等于多少刀、额度怎么算、有没有积分体系。 kukuai.fyi 的计费思路和传统「积分盘」不太一样。我们更愿意把它理解成AI 电网：Token 就像 AI 世界里的电力，按真实消耗计费，而不是先把人民币换成一层空气积分。
AI Grid
我们卖的不是「积分」，而是稳定的 AI Token 电力。
就像用电按度计费、用水按吨计费，AI 使用也应该回到真实资源消耗： 你实际用了多少 Token，就清楚看到花了多少钱。
字段
类型
必填
说明
传统中转站
积分盘 / 虚拟额度
可选
充值后先换成虚拟额度、刀或积分，不同模型再乘倍率，用户需要自己换算真实成本。
kukuai.fyi
人民币余额 / Token 电力
必填
充值 1 元就是账户 1 元余额，模型实际消耗多少就扣多少，成本以人民币清晰呈现。
传统中转站积分盘 / 虚拟额度充值后先换成虚拟额度、刀或积分，不同模型再乘倍率，用户需要自己换算真实成本。
kukuai.fyi人民币余额 / Token 电力必填充值 1 元就是账户 1 元余额，模型实际消耗多少就扣多少，成本以人民币清晰呈现。
我们的计费方式
- 按人民币真实计价：充值 1 元 = 账户 1 元余额。
- 按模型实际消耗扣费：模型实际消耗多少 Token，就按对应实时单价扣多少。
- 不玩复杂倍率：不需要研究 0.5x、2x、组倍率或虚拟额度换算。
- 成本透明可追踪：每次请求都能看到 token usage，用量、扣费和排障都围绕真实数据展开。
用户常问：倍率、额度、积分
如果你之前使用的是「充值 → 换额度 / 刀 / 积分 → 再按模型倍率扣除」的中转站， 可以用下面的方式理解 kukuai.fyi：
- **你们倍率多少？**没有传统积分盘里的复杂倍率。不同模型有不同实际单价，最终以人民币余额扣费。
- **1 块等于多少刀？**1 元就是账户 1 元余额，不再先折算成虚拟美元额度或空气积分。
- **额度怎么算？**额度就是人民币余额和模型实际消耗。看 Token 用量、看人民币扣费，不需要二次换算。
- **有没有积分体系？**核心计费不依赖积分体系。我们更偏向「电费模式」：透明、简单、可长期开发。
限速与配额
SLA 与状态
kukuai.fyi 是统一网关，整体可用性同时受网关本身和上游 provider 共同决定。 在启用智能路由的账号上，单个 provider 故障会自动切换到备用 provider， 进一步降低对应用的影响。