OFFICIALSOLEAPI.COM · 官方正版站 · 唯一域名

AI API 中转站Claude · GPT · Gemini一个 Key，30+ 大模型.

KumoAPI 是面向开发者的大模型 API 聚合平台。OpenAI、Anthropic、Gemini 三种协议原生直通，Claude Code、Codex、Cursor 只改一个接口地址就能接入；按量计费、支付宝充值、没有月费，上游过载或限流时在第一帧之前自动切换货源。本页是 KumoAPI 的官方说明页，所有信息以 kumoapi.com 为准。

免费注册，领取体验额度查看 30+ 模型实时价格

30+主流模型 3种协议原生直通 7 天可用率逐模型公开 0月费 · 0最低充值

官网域名: kumoapi.com
API 地址: api.kumoapi.com
运营主体: Oryntis, LLC（美国）
密钥前缀: sk-sole-
充值渠道: 支付宝 · Stripe · USDT
第三方代充: 不授权

01 · 怎么确认官方站

怎么确认你打开的是 KumoAPI 官方站

KumoAPI 只有一个官网：kumoapi.com。随着站点被更多人搜索，出现了以 KumoAPI 名义引流的相似域名、镜像页和群内「代充」渠道。它们与 KumoAPI 没有任何关系，在那里输入的账号密码与密钥都可能被盗用，付出去的钱也不会到账。下面四步在 30 秒内可以完成核对。

看地址栏

域名必须是 kumoapi.com，证书有效、带锁标志。KumoAPI 只有一个子域名 api.kumoapi.com，用于接口调用，不承载任何登录或支付页面。其他任何前缀、后缀、相似拼写（多一个字母、把 l 换成 1 之类）都不是官方。

看密钥

API Key 只能由你自己在控制台「API Key」页创建，前缀一律是 sk-sole-。别人代开的 Key、群里「共享」的 Key、带其他前缀的 Key，要么不是 KumoAPI 签发的，要么随时会被原主人吊销，不要使用。

看付款

充值只在控制台「我的钱包」发起，支持支付宝、国际信用卡（Stripe）与 USDT，收款方是 KumoAPI / Oryntis。官方不授权任何第三方代充，不会以「内部优惠」「折扣充值」「先转账后到账」的名义要求站外付款，也没有任何个人收款码或个人钱包地址。

看联系渠道

官方的联系方式只在 kumoapi.com/zh/contact 公布。任何主动私信你、声称是「KumoAPI 客服」「KumoAPI 代理」并要求转账或索要密钥的，都不是官方行为。遇到可疑站点或代充渠道，欢迎通过官方联系渠道反馈。

一句话记住：只在 kumoapi.com 登录、充值、建 Key；Key 以 sk-sole- 开头；没有代充。

02 · 什么是 AI API 中转站

什么是 AI API 中转站，KumoAPI 怎么工作

AI API 中转站，也叫大模型 API 聚合平台或 API 网关，是架在你的应用与 Anthropic、OpenAI、Google 等上游厂商之间的一层统一入口。你的代码只认一个接口地址和一把 Key，网关负责鉴权、计量、路由与容错，再把请求转给对应厂商，把结果原样送回。对调用方来说，它就是一个同时兼容 OpenAI 协议、Anthropic 协议与 Gemini 协议的 API 端点。

它解决的是「每多接一家厂商就多一套账号、一套密钥、一张账单、一套故障处理」的问题。直连当然可以，但当你同时在用第三家的 SDK、第五把密钥和又一张对不上的账单时，分散接入的成本不在第一天，而在每一天。经由 KumoAPI 一个入口，换模型只改一个字符串，官方出故障时网关自动换货源，所有调用汇成一张人民币账单，按密钥拆分预算与权限。

一次请求在 KumoAPI 里经过什么

鉴权与预算。校验 Key、检查这把 Key 的可用模型、预算上限、IP 白名单与并发限制。
数据脱敏（可选）。开启后，请求在转发前自动识别并遮蔽其中的 API 密钥、令牌、邮箱等敏感信息。
选路。同一模型挂多条货源，按延迟、健康度与价格动态选择，过载的货源自动降权。
转发与容错。协议原生直通，不做格式翻译；上游返回错误、过载或限流时，在第一帧之前切换货源重发。
计量。按上游返回的真实 Token 数逐请求记账，明细进用量页，余额同步扣减。

KumoAPI 与多数中转站的四个差别

协议原生直通

Claude 走 Anthropic Messages 协议，Gemini 走 generateContent 协议，不先翻译成 OpenAI 格式再翻回去。思考过程、工具调用、流式输出与直连完全一致，Claude Code 这类对协议细节敏感的工具不会在边角出问题。

按人民币记账的真实折扣

模型目录标注上游官方价，实际按 Credits 扣费、按人民币充值。价目表每一行都带划线官方价与真实折扣百分比，汇率取 Stripe 实时汇率并公开，不需要你自己换算。

稳定性数据公开

每个模型近 7 天的探测记录、可用率与 p95 延迟都在模型页，下单前就能看到，不靠群里问「最近稳不稳」。

密钥级的治理

每把 Key 可以单独限模型、限预算、限 IP、限并发，用量与账单按 Key 拆分；团队共用一份余额，各自有上限。

03 · 支持的模型与厂商

支持的模型与厂商：Claude、GPT、Gemini 与国产大模型

KumoAPI 当前上架 30 余个会话模型，覆盖 Anthropic、OpenAI、Google 三大厂商的全部主力系列，以及 DeepSeek、阿里通义千问、Moonshot Kimi、火山引擎豆包、xAI Grok 等。模型目录每 5 分钟与后台同步，上下架实时生效；每个模型有独立页面，列出价格、上下文长度、能力矩阵、近 7 天可用率与协议示例。

厂商	模型系列	协议	典型工具	站内页面
Claude	Opus、Sonnet、Haiku 全系，含扩展思考与提示缓存	Anthropic Messages 原生；也可按 OpenAI 格式调用	Claude Code、Cursor、Cline	Claude 中转站对比 · 全部模型
GPT	GPT 系列、o 系列推理模型，图像与视频生成	OpenAI Chat Completions 与 Responses	Codex、Cursor、各类 OpenAI SDK	Codex 接入 · 全部模型
Gemini	Gemini Pro、Flash，长上下文与多模态	Google generateContent 原生；也可按 OpenAI 格式调用	Gemini CLI、Google GenAI SDK	Gemini CLI 接入 · 全部模型
DeepSeek	V 系列、R 系列推理模型	OpenAI Chat 格式	任何 OpenAI 兼容客户端	模型目录
通义千问	阿里 Qwen 系列	OpenAI Chat 格式	任何 OpenAI 兼容客户端	模型目录
Kimi	Moonshot Kimi 系列	OpenAI Chat 格式	任何 OpenAI 兼容客户端	模型目录
豆包	火山引擎豆包系列	OpenAI Chat 格式	任何 OpenAI 兼容客户端	模型目录
Grok	xAI Grok 系列	OpenAI Chat 格式	任何 OpenAI 兼容客户端	模型目录

Claude API 中转站

这是 KumoAPI 使用量最大的一类需求。Anthropic 官方只收海外信用卡，订阅制又有用量窗口限制，国内开发者绕不开中转。KumoAPI 的 Claude 模型走 Messages 协议原生直通：扩展思考、工具调用、提示缓存、流式输出一个字段不改，Claude Code、Cursor、Cline 这些按 Messages 协议工作的工具直接可用。同一把 Key 也能按 OpenAI 格式调用 Claude，已经写好的 OpenAI 代码不用动。官方过载、限流时由网关在第一帧之前切换货源。想比价和看可用率，站内有专门的 Claude 中转站价格与稳定性对比页。

GPT API 中转

OpenAI 侧同时支持 Chat Completions 与 Responses 两种格式。Codex CLI 用 Responses 格式原生接入；Cursor、LangChain、各语言的 OpenAI SDK 把接口地址换成 KumoAPI 的 OpenAI 兼容入口即可，函数调用、结构化输出、流式用量统计一并保留。o 系列推理模型、图像与视频生成模型也在同一个入口下。

Gemini API 中转

Google GenAI SDK 与 generateContent 协议原生直通，Gemini CLI 改一个接口地址变量就能用；也可以用 OpenAI 格式调用 Gemini。对需要在 Claude、GPT、Gemini 之间做 A/B 或降级的产品，这意味着三家模型共用一套代码、一把 Key 和一份余额。

DeepSeek、通义千问、Kimi、豆包、Grok

国产与其他厂商的模型按 OpenAI Chat 格式统一调用，适合把便宜的日常任务和贵的旗舰模型放在同一个项目里，按密钥拆分预算，月底一张账单。

04 · Claude Code 中转站

Claude Code 中转站：为什么用、怎么接

Claude Code 是目前对中转站要求最高的客户端之一：它走 Anthropic Messages 协议，大量使用流式输出、工具调用和扩展思考，任何一处协议翻译的偏差都会表现为「卡住」「工具调用失败」「输出截断」。KumoAPI 对 Claude 模型做的是原生直通，请求体与官方完全一致，这是它能稳定跑 Claude Code 的前提。

为什么用中转站跑 Claude Code

不受订阅额度限制。按 Token 计费，用多少扣多少，没有「用完等窗口重置」。
支付宝人民币充值。不需要海外信用卡；团队可以共用一份余额，每人一把 Key、各自设预算上限。
官方故障不中断。Anthropic 返回服务器错误、过载或限流时，网关在第一帧之前切换货源重发，终端里看不到报错。
协议不翻译。思考过程、工具调用、流式输出与直连一致。

接入只需要两步

在控制台「API Key」页新建一把 Key，可以顺手给它限定只能用 Claude 模型、设一个月度预算。
把 Claude Code 的接口地址环境变量指向 api.kumoapi.com，密钥环境变量换成刚才的 sk-sole- 密钥，然后正常启动 Claude Code。不需要改配置文件，也不需要任何代理脚本；想固定默认模型的话再加一个模型环境变量即可。macOS、Linux、Windows 与 settings.json 三种写法在 Claude Code 接入教程里都有，照抄即可。

接入后常见情况

提示认证失败通常是密钥不是 sk-sole- 开头，或接口地址变量没有在当前终端生效，新开一个终端再试。

提示模型不存在模型名要用目录里的调用名，去模型页复制。

持续提示限流多半是这把 Key 自己设的预算或并发上限到了，在控制台调整；上游侧的限流由网关自动切换，一般不会透出。

提示余额不足充值后立即恢复，建议在设置里开额度预警。

05 · 工具接入

Codex、Cursor、Gemini CLI 与 SDK 的接入方式

所有工具的接入逻辑都一样：把接口地址换成 KumoAPI，把密钥换成 KumoAPI 签发的。请求体与官方一致，不需要补丁。

Codex CLI

在 Codex 的配置文件里新增一个模型提供方，接口地址指向 KumoAPI 的 OpenAI 兼容入口，通信格式选 Responses，密钥放在环境变量里。站内 Codex 接入教程给出了完整配置。

Cursor

在 Cursor 设置的模型页填入 KumoAPI 的 Key，并把 OpenAI 接口地址覆盖为 KumoAPI 的 OpenAI 兼容入口，保存后即可在模型列表里选 Claude 或 GPT。

Gemini CLI

把 Google GenAI 的接口地址变量指向 api.kumoapi.com，密钥变量换成 KumoAPI 的 Key，启动时指定 Gemini 模型即可。见 Gemini CLI 接入教程。

OpenAI / Anthropic / Google SDK

Python、Node、Go 等各语言官方 SDK 都支持自定义接口地址，初始化时改接口地址与密钥两项即可，业务代码不动。每个模型页都给出 cURL、Python、Node 三种示例。

06 · 计费方式

按量、无月费、每一笔都有明细

KumoAPI 按量计费，充值即用。没有月费，没有最低充值，没有套餐，余额按实际消耗扣减，不用就不扣。注册先送体验额度，可以先跑通再决定充不充。

价格怎么看

模型目录里标注的是各厂商的官方价，实际扣费以 Credits 记账、按人民币充值。价目表每一行都同时给出划线官方价与真实折扣百分比，汇率取 Stripe 实时汇率并在页面上公开，你不需要自己换算。不同供货渠道的倍率可能不同，模型页会逐渠道列出。价格与模型目录同源，每 5 分钟刷新。

账单能细到什么程度

每一次调用的模型、输入与输出 Token 数、缓存命中、单价、费用、首字延迟与渠道都记在用量页，可以按 Key、按模型、按时间段筛选与导出。团队用一份余额时，每把 Key 的消耗各自可查，月底不需要从各家后台拼表。

预算与预警

每把 Key 可以单独设预算上限与可用模型；账户层面可以设余额预警阈值，低于阈值时邮件或 Webhook 通知，不会在半夜被静默扣空。

支付方式

支付宝、国际信用卡（Stripe）、USDT，全部在控制台「我的钱包」内完成，人民币账单。再强调一次：官方不授权任何第三方代充，所有站外的「代充」「内部价」都不是 KumoAPI。

07 · 稳定性机制

上游出问题时，你的请求照样有结果

中转站的「稳定」不是服务器不宕机，而是 Anthropic、OpenAI 这些上游过载、限流、故障的时候，你的请求照常返回。KumoAPI 靠四条机制做到这一点，并且把结果数据公开给所有人。

首帧前自动切换

同一模型挂多条货源。上游返回服务器错误、过载或限流时，网关在第一帧发出之前就换货源重发，客户端看到的仍是一次正常响应。

多把上游密钥分摊限额

每家厂商的速率限额按密钥计，KumoAPI 用多把上游密钥分摊：一把被限流就换下一把，不用等窗口重置。每把上游密钥都有熔断器与滑动窗口健康指标。

按健康度调度

每条货源持续探测，延迟高、错误率升的自动降权，请求优先走健康的那条；恢复后自动回流。

零缓冲流式转发

流式响应的每一帧收到即转发，不攒包，网关附加延迟以毫秒计，流式体验与直连一致。

数据公开。平台对主力模型定时发探针，近 7 天的探测记录、可用率与 p95 延迟在每个模型页与控制台「模型健康」页对所有用户公开。选模型、比中转站的时候，看数据，不看口碑。

08 · 安全与合规

不训练、少留存、密钥可治理

数据脱敏

可在个人设置中开启。开启后，请求在转发给上游之前会自动识别并遮蔽其中的 API 密钥、访问令牌、邮箱等敏感信息，规则库基于 gitleaks 等开源规则并定时自动更新。适合把生产日志、配置文件直接丢给模型分析的场景。

不训练、少留存

KumoAPI 不使用你的请求数据训练任何模型。传输全程 TLS 加密；明细日志只保留计量必需的 Token 数与耗时元数据。

密钥与账户

每把 Key 可以限模型、限预算、限 IP 白名单、限并发，泄露时一键吊销；账户支持两步验证。KumoAPI 由美国 Oryntis, LLC 运营，服务条款、隐私政策与退款政策均公开。

09 · 三条路的区别

与官方直连、海外聚合平台的区别

同样是调 Claude 或 GPT，三条路的差别不在模型本身，而在计价币种、支付方式、协议处理与故障处理。

维度	官方直连	海外聚合平台（OpenRouter 等）	KumoAPI
计价	官方美元价	官方美元价一比一	人民币记账，价目表逐行标真实折扣
汇率与手续费	按信用卡结算汇率	按平台汇率，充值另收手续费	Stripe 实时汇率公开，无充值手续费
支付方式	海外信用卡	国际卡、加密货币	支付宝、信用卡、USDT，人民币账单
月费与最低充值	无月费，需预充	无月费，充值收手续费	无月费、无最低充值，注册送体验额度
上游错误、过载、限流	自己写重试	视平台而定	首帧前自动切换货源，多把上游密钥分摊限额
协议	各家原生	多为 OpenAI 格式翻译	Messages、Gemini 原生直通，同时支持 OpenAI 格式
Claude Code、Codex、Cursor	支持	视平台而定	支持，改接口地址即可
账单与预算	按账号	按平台账号	按模型、按 Key 拆分；Key 可限预算、模型、IP
稳定性数据	官方状态页	部分公开	逐模型公开近 7 天探测记录与可用率

10 · 适合谁

KumoAPI 适合谁

Claude Code、Cursor 的重度用户

不受订阅额度限制，支付宝按量充值，一把 Key 跑所有编码工具，每次请求的消耗都能查到。

两三个人的小团队

共用一份余额，每人一把 Key、各自设上限；账单按 Key 拆分，谁用了多少一目了然。

做 AI 产品的团队

Claude、GPT、Gemini 用同一套代码切换做 A/B 与降级；上游故障自动切换，不用自己写重试与熔断；用量按模型、按 Key 归因。

对合规有要求的企业

IP 白名单、数据脱敏、两步验证、Webhook 额度预警；企业合作与定制额度可通过联系我们。

11 · 常见问题

关于 KumoAPI 官网与中转站的常见问题

KumoAPI 的官网是哪个？怎么确认我打开的是官方站？

KumoAPI 官网唯一域名是 kumoapi.com，API 地址是 api.kumoapi.com，由美国 Oryntis, LLC 运营。核对三点就够：地址栏域名是 kumoapi.com 且证书有效；API Key 只能在本站控制台创建，一律以 sk-sole- 开头；充值只在控制台内完成，官方不经第三方代充、不私下转账。

什么是 AI API 中转站？和直连官方有什么区别？

AI API 中转站，也叫大模型 API 聚合平台，是架在你的应用与 Anthropic、OpenAI、Google 等上游之间的统一网关：一个 Key、一个 Base URL 调用所有模型，网关负责鉴权、路由、容错、计量与账单。模型与协议和官方完全一样，多出来的是上游故障时的自动切换、支付宝人民币充值、按密钥拆分的预算控制，以及按人民币记账带来的真实折扣。

KumoAPI 怎么计费？有月费或最低充值吗？

按量付费，用多少扣多少，没有月费，也没有最低充值。模型目录标注的是上游官方价，实际扣费按 Credits 记账，价目表每一行都带划线官方价与真实折扣，汇率取 Stripe 实时汇率并公开。注册即送体验额度，余额不足会提前邮件提醒。

Claude Code 怎么接入 KumoAPI？

把 Claude Code 的接口地址环境变量指向 api.kumoapi.com，密钥换成 KumoAPI 签发的 sk-sole- 密钥，然后正常启动即可，不需要改配置文件，也不需要任何代理脚本。Claude 模型走 Anthropic Messages 协议原生直通，思考过程、工具调用与流式输出和直连一致。完整步骤见站内 Claude Code 接入教程。

Codex、Cursor、Gemini CLI 能用吗？

能。按 OpenAI 格式工作的工具（Codex、Cursor、各类 OpenAI SDK）把接口地址改成 KumoAPI 的 OpenAI 兼容入口；Gemini CLI 改 Google GenAI 的接口地址变量。所有工具共用同一个 Key 和同一份余额，站内各有图文教程。

KumoAPI 稳定吗？官方限流或过载时会怎样？

同一模型挂多条货源，上游返回服务器错误、过载或限流时，网关在第一帧之前就切换货源重发，客户端看不到报错；多把上游密钥分摊速率限额；每条货源持续探测、按健康度调度。每个模型页公开近 7 天探测记录、可用率与 p95 延迟。

KumoAPI 支持代充吗？怎么充值？

官方不经任何第三方代充，也不会以任何名义要求私下转账。充值只在 kumoapi.com 控制台的「我的钱包」完成，支持支付宝、国际信用卡（Stripe）与 USDT。遇到「代充」「内部价」「先转账后到账」一律不要付款。

我的数据安全吗？会被用来训练模型吗？

不会用你的请求数据训练任何模型。传输全程 TLS 加密；可开启数据脱敏，转发前自动遮蔽请求中的 API 密钥、令牌、邮箱等敏感信息；明细日志只保留计量必需的 Token 数与耗时元数据。密钥可限模型、限预算、限 IP，泄露时一键吊销。

会降智或限速吗？模型和官方一样吗？

模型一样、协议一样，请求体不改一个字段，思考过程、工具调用、流式输出原样转发。速率上限由你自己给 Key 设的预算与并发决定；上游限流由网关用多把密钥分摊与切换，一般不会透出到客户端。

和 OpenRouter 这类海外聚合平台比，差别在哪？

海外聚合平台按官方美元价一比一结算、充值另收手续费、需要国际卡，Claude 多半经 OpenAI 格式翻译。KumoAPI 按人民币记账、支付宝充值、人民币账单，Claude 与 Gemini 走各自原生协议直通，价目表逐行标真实折扣，稳定性数据公开。

换一个接口地址，Claude、GPT、Gemini 便宜又稳定地跑起来

注册即送体验额度，支付宝充值，按量计费没有月费。记住：官网只有 kumoapi.com，没有代充。

免费获取 API Key