kukuai API 文档统一大模型 API 网关

从一行配置开始，后面都交给网关 ​

你继续使用熟悉的 SDK、工具和请求结构，kukuai.fyi 负责模型聚合、线路选择、用量记录和后续扩展。对于已经接入 OpenAI 兼容协议的项目，通常只需要把 base_url 改为：

https://www.kukuai.fyi/api-proxy/china/v1

• 一行 base_url：把现有 OpenAI 兼容 SDK 的 base_url 指到 https://www.kukuai.fyi/api-proxy/china/v1，业务代码基本不用动。
• 一个入口切全部模型：Claude、GPT、Gemini、DeepSeek、Qwen 等模型使用同一套请求结构和鉴权方式。
• 多模态统一接入：Chat / Image / Video / Audio 统一管理，模型能力通过 model 字段自由切换。
• Codex 工具恢复：工具突然不可调用时，先检查文件工具是否可用，恢复后从第一步重新落代码。
• 透明用量：请求级别 token、时延、状态记录，便于成本追踪与排障。
• 智能路由：同一模型多 provider 自动备援，单点故障不影响业务。
• 开发者优先：清晰错误码、稳定字段、长期不变更的请求结构。
• 集成指南：覆盖 ChatBox、Cherry Studio、Claude Code、Cursor、Codex CLI、Dify 等常见工具教程。

官网能力概览 ​

kukuai.fyi 官网控制台面向 API 用户提供注册登录、API Key 管理、模型定价、套餐订阅、充值、调用日志和账户设置。文档里的示例统一使用官网公开的 API 代理端点：

https://www.kukuai.fyi/api-proxy/china/v1

官网首页当前重点展示这些能力：

• 统一 API 网关：用 OpenAI 兼容协议调用多家厂商和自托管模型。
• 模型与定价可见：在「模型定价」中查看不同模型的输入、输出、缓存和按次价格。
• API Key 自助管理：登录后进入「获取 APIKEY」页面创建和管理密钥。
• 余额与套餐：支持余额充值、套餐订阅和用量查看，适合测试、个人项目和生产服务分开管理。
• 调用日志：控制台可查看每次 API 调用的模型、Token、耗时、扣费和错误信息，便于排障。

操作说明 ​

1. 打开 kukuai.fyi 官网，点击注册或登录账号。
2. 进入 获取 API KEY 页面，新建一把 API Key。密钥只会展示一次，建议立即保存到自己的 Secret Manager 或环境变量。
3. 如需正式调用，进入官网的「充值」或「套餐方案」页面，为账号准备可用余额或订阅额度。
4. 在你的应用里把 OpenAI SDK 的 base_url 改为 https://www.kukuai.fyi/api-proxy/china/v1，并把 API Key 放入 Authorization: Bearer。
5. 先用 快速开始 的 cURL 示例完成一次非流式调用，再接入 Python、Node.js 或第三方工具。
6. 上线后在官网「调用日志」查看请求状态、Token 消耗、扣费和错误信息；如遇到 401、429 或模型不可用，再对照 错误码 排查。

最小调用示例 ​

export KUKUAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

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"}
    ]
  }'