kukuai AI 中转站：OpenAI、Claude、Gemini 多模型统一 API 接入指南

kukuai AI 中转站是一套面向开发者的 AI API 中转与统一大模型网关，支持 OpenAI 兼容接口、Claude API 中转、Gemini 图片生成、国内直连、海外线路和人民币透明计费。

kukuai.fyi 可以理解为面向开发者和团队的 AI 中转站、AI API 中转站 或 大模型统一网关。它的目标不是让你重新学习一套协议，而是把常见模型调用方式整理成更稳定的接入入口。

对已经使用 OpenAI SDK、Claude Code、Cursor、Cline、ChatBox、Cherry Studio、Dify 等工具的用户来说，最重要的变化通常只有两件事：替换 base_url，以及把 API Key 换成 kukuai.fyi 控制台生成的 Key。

为什么需要 AI API 中转站

当团队同时使用 GPT、Claude、Gemini、DeepSeek、Qwen、图片模型和视频模型时，每家厂商的 endpoint、鉴权方式、错误格式、模型命名和网络线路都可能不同。如果每个项目都单独维护一套接入逻辑，迁移成本会持续上升。

痛点

没有中转站时

使用 kukuai.fyi 后

多模型切换

每家厂商维护不同 SDK、Endpoint 和鉴权方式

优先使用统一 Base URL 和 model 字段切换模型

国内访问

网络不稳定、团队成员环境差异大

按线路选择默认入口、图片加速入口或海外入口

工具接入

ChatBox、Cursor、Claude Code、Dify 各配一遍

按 OpenAI 兼容或 Claude 兼容选择对应教程

成本理解

积分、倍率、虚拟刀换算复杂

按人民币余额和实际模型消耗理解成本

核心能力

OpenAI API 中转：支持常见 OpenAI 兼容 SDK 和工具，把 base_url 指向 https://www.kukuai.fyi/api-proxy/china/v1。
Claude API 中转：Claude / Anthropic 风格工具通常使用根地址 https://www.kukuai.fyi/api-proxy/china。
Gemini 图片生成：Google / Gemini 图片生成、NanoBanana2 等图片模型按专用图片接口接入。
多模型导航：通过模型导航浏览 Chat、Image、Video、Audio 分类模型。
工具集成教程：提供 ChatBox、Cherry Studio、AnythingLLM、Claude Code、Cursor、Cline、Codex CLI、Dify 等教程。
透明用量心智：不使用复杂积分倍率表达，具体用量、扣费、权限和限速以控制台为准。

Base URL 选择

搜索“kukuai AI 中转站怎么接入”时，最常见的问题就是 Base URL 填错。简单规则是：OpenAI 兼容工具一般带 /v1，Claude 风格工具一般使用根地址。

base-url-maptext

OpenAI 兼容 Base URL:
https://www.kukuai.fyi/api-proxy/china/v1

Claude / Anthropic 兼容 Base URL:
https://www.kukuai.fyi/api-proxy/china

Google / Gemini 图片生成 Base URL:
https://www.kukuai.fyi/api-proxy/china

海外直连:
https://www.kukuai.fyi/api-proxy/china/v1

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

tool-maptext

OpenAI SDK / Cursor / Cline / ChatBox / Cherry Studio:
  Base URL: https://www.kukuai.fyi/api-proxy/china/v1

Claude Code / Anthropic SDK:
  Base URL: https://www.kukuai.fyi/api-proxy/china

Gemini 图片生成 / NanoBanana2:
  Base URL: https://www.kukuai.fyi/api-proxy/china
  Endpoint: /v1beta/models/{MODEL}:generateContent

快速接入示例

如果你只想验证 kukuai AI 中转站是否能调用模型，优先使用 cURL 发一条最小请求。 cURL 能通以后，再去配置 SDK、桌面客户端或 Agent 工具。

kukuai-ai-proxy-smoke-test.shbash

export KUKUAI_API_KEY="sk-你的-kukuai-api-key"

curl https://www.kukuai.fyi/api-proxy/china/v1/chat/completions \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-2-chat-latest",
    "messages": [
      {"role": "user", "content": "用一句话介绍 kukuai AI 中转站"}
    ]
  }'

更完整的 SDK 示例可以继续看 Python SDK、Node.js SDK 和 cURL 文档。

适合接入哪些工具

工具 / 场景

推荐入口

说明

OpenAI SDK / cURL / Cursor / Cline

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

按 OpenAI 兼容协议接入，通常只改 base_url 和 api_key。

Claude Code / Anthropic SDK

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

按 Claude / Anthropic 风格接入，避免把 /v1 填到根地址后面。

ChatBox / Cherry Studio / AnythingLLM

集成指南

适合桌面聊天、知识库和多模型管理。

Dify / 工作流平台

Dify 接入教程

适合应用、工作流、知识库和 Agent 编排。

Gemini / NanoBanana2 图片生成

Google 图片生成 API

图片模型使用 Google / Gemini 原生兼容接口，不要套用普通文本模型接口。

Token 电力计费心智

token-powertext

传统积分盘：
充值 → 换算虚拟额度 / 刀 / 积分 → 模型倍率 → 用户自己反推真实成本

kukuai.fyi：
充值 1 元 = 账户 1 元余额
模型实际消耗多少，就按真实人民币余额扣多少
不需要每天研究倍率、积分和虚拟额度

这意味着你不需要把时间花在复杂倍率、积分包和虚拟额度换算上。你更应该关注：实际用了多少 Token、请求使用了哪个模型、控制台显示扣费是多少。

搜索常见问题

kukuai-ai-proxy-faqtext

Q: kukuai AI 中转站是不是只能转 OpenAI？
A: 不是。kukuai.fyi 面向多模型统一接入，文档示例默认使用 OpenAI 兼容协议，同时也覆盖 Claude / Anthropic 风格、Google / Gemini 图片生成等接入方式。

Q: OpenAI 兼容工具应该填哪个 Base URL？
A: 通常填 https://www.kukuai.fyi/api-proxy/china/v1。

Q: Claude Code 应该填哪个 Base URL？
A: Claude / Anthropic 风格通常填 https://www.kukuai.fyi/api-proxy/china，不要额外加 /v1。

Q: 1 元等于多少刀或多少积分？
A: kukuai.fyi 不采用传统积分盘心智。充值 1 元就是账户 1 元余额，模型实际消耗多少就扣多少，具体用量和扣费以控制台为准。

Q: 模型价格、限速和上下文长度能不能写死？
A: 不建议。模型政策、上游能力和账号权限会变化，准确值应以 kukuai.fyi 控制台当前配置为准。

Q: 为什么旧文档或历史截图里的线路和当前不一样？
A: 这些是历史线路或内部上游域名。当前用户侧默认使用 https://www.kukuai.fyi/api-proxy/china/v1；Anthropic / Claude 风格工具使用 https://www.kukuai.fyi/api-proxy/china。

接入建议

checklisttext

接入前检查：

1. 已注册 kukuai.fyi 账号
2. 已在控制台创建 API Key
3. 已确认工具属于 OpenAI 兼容还是 Claude 兼容
4. 已复制真实模型 ID
5. 已选择默认线路
6. 已准备一条最小测试请求
7. 已知道用量、价格、限速以控制台为准

第一次接入先用轻量模型跑通，不要一开始就接复杂工作流。
每个项目或工具单独创建 API Key，便于统计、限额和停用。
把模型 ID 从模型导航或 GET /v1/models 复制，不要凭记忆手写。
生产环境不要把 API Key 写到前端代码里，应放在服务端或安全配置里。
遇到 401、404、429、503 时，先看错误码，再排查模型名、Base URL、余额和限速。

下一步

如果你是第一次接入，先看快速开始。
如果你要迁移完整项目，看完整接入手册。
如果你要配置具体客户端，看集成指南。
如果你要了解认证、余额和扣费，看认证与计费。

kukuai AI 中转站：OpenAI、Claude、Gemini 多模型统一 API 接入指南 ​

为什么需要 AI API 中转站 ​

核心能力 ​

Base URL 选择 ​

快速接入示例 ​

适合接入哪些工具 ​

Token 电力计费心智 ​

搜索常见问题 ​

接入建议 ​

下一步 ​