新手区
第一次使用 kukuai.fyi，按三步走：注册账号、创建 APIKEY、复制端点调用。
1. 注册账号
打开 kukuai.fyi 官网，注册或登录账号。
登录后先确认能进入控制台，并能看到 APIKEY、模型、余额、调用日志等入口。后续创建密钥、查看参考价、排查请求都在控制台完成。
2. 创建 APIKEY
创建 APIKEY 前，先看你准备调用模型的参考价。不同模型、不同能力和不同分组的价格可能不同，正式接入前建议先确认预算和调用量。
建议顺序：
text
1. 进入模型或价格页面
2. 查看目标模型参考价
3. 确认要用全站 Key 还是分组 Key
4. 创建 APIKEY
5. 立即复制并保存完整 Key先看参考价
在控制台查看目标模型的输入、输出、缓存、图片或视频等参考价，再决定是否用于测试或生产。
如果只是第一次测试，优先选择成本可控的模型，并用少量请求验证。上线前再按真实业务场景选择高质量模型或多模型组合。
选择全站或分组
APIKEY 可以按使用范围管理：
| 类型 | 适合场景 | 建议 |
|---|---|---|
| 全站 APIKEY | 个人测试、单项目快速接入、临时验证 | 使用简单，但权限范围更大，注意保管。 |
| 分组 APIKEY | 团队项目、生产服务、不同客户端分开统计 | 推荐生产使用，便于按项目、工具或业务线拆分权限和用量。 |
生产环境建议使用分组 APIKEY：例如 backend-prod、cursor-dev、image-worker 分开创建。这样某个客户端异常调用时，可以快速定位、限额或停用，不影响其他业务。
保存 APIKEY
APIKEY 只在创建时完整展示，复制后保存到环境变量、服务器 Secret Manager、CI/CD Secret 或后端配置中。
bash
export KUKUAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"不要把 APIKEY 放进前端页面、移动端包体、公开仓库、截图或日志。
3. 复制端点调用
OpenAI 兼容推荐端点：
text
https://www.kukuai.fyi/api-proxy/china/v1把它作为 base_url 或 baseURL，并在请求 Header 里带上 APIKEY：
text
Authorization: Bearer <KUKUAI_API_KEY>最小 cURL
bash
curl https://www.kukuai.fyi/api-proxy/china/v1/chat/completions \
-H "Authorization: Bearer $KUKUAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-8",
"stream": false,
"messages": [
{"role": "user", "content": "用一句话介绍 kukuai.fyi"}
]
}'复制时检查
| 项目 | 正确写法 |
|---|---|
| Base URL | https://www.kukuai.fyi/api-proxy/china/v1 |
| Chat Endpoint | /chat/completions |
| Header | Authorization: Bearer <KUKUAI_API_KEY> |
| Model | 复制模型导航或控制台里的真实 Model ID |
如果客户端只要求填写 Base URL，不要把 /chat/completions 也填进去；如果客户端要求填写完整接口地址，再使用完整 URL。