Skip to content

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

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

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、余额和限速。

下一步 ​

统一 API 网关 · OpenAI Compatible