文档
快速入门
Kunavo 与 OpenAI API 协议兼容。如果你已经在使用 OpenAI SDK,只需更改 base URL。从零开始,五分钟即可发出首次前沿模型调用。
Kunavo 是一个独立且兼容 OpenAI 的 AI API 网关:只需一个 API 密钥和一个按量付费余额,即可调用 Claude、GPT 以及图像、视频和音频模型,无需为每个提供商单独开设账户。 整个接入过程分为四个步骤。前三步只需完成一次。第四步——发起调用——只需替换 base_url。
1. 创建账户
使用 Google 或电子邮件魔法链接,在 kunavo.com/app/login 注册。采用按量付费模式,充值金额最低为 $10——余额永不过期,失败的请求也不会计费。
2. 创建 API 密钥
在控制台中打开 /app/keys,然后点击 新建密钥。密钥以 sk-kn- 开头,并且在创建时仅显示一次——请复制并妥善保管。
安全使用建议:
- 每个项目/环境(dev、staging、prod)使用一个密钥。
- 发生安全事件时或每季度轮换密钥。
- 如果在 CI 中通过脚本调用,请为每个密钥设置月度支出上限。
请像对待密码一样保护 API 密钥。切勿将其提交到 git 仓库或打包进客户端代码。请使用环境变量和密钥存储服务。
3. 为钱包充值
前往 /app/billing 充值。充值金额最低为 $10,足以使用真实密钥试用每个模型,且余额永不过期。
- 任何地区都能用:TRON 链上的 USDT(TRC-20)或 Base 链上的 USDC,按充值页给出的地址和精确金额转账。
- 用本币付款:支付宝(中国大陆)、AlipayHK(中国香港)、Pix(巴西)、GCash(菲律宾)、Touch 'n Go eWallet / Boost(马来西亚)、PayNow(新加坡)、K PLUS / LINE Pay(泰国);付款前,充值页会显示折算后的本币金额。
- 银行卡付款正在开通,暂时还不能用。
- 按量付费:使用费用实时从钱包余额中扣除,无需订阅。
- 适用大额充值奖励:$100 → +$10,$1,000 → +$200,$5,000 → +$1,250。
4. 发起首次调用
从模型目录中选择任意已启用的模型。下面以一次低成本、快速的 claude-haiku-4-5 聊天调用为例,帮助你验证配置。
Python(OpenAI SDK)
openai Python 包(v1+)开箱即用——只需将 base_url 指向 Kunavo。
first_call.py
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1",
)
resp = client.chat.completions.create(
model="claude-haiku-4-5",
messages=[{"role": "user", "content": "Say hi in one sentence."}],
)
print(resp.choices[0].message.content)Node.js
first_call.mjs
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-haiku-4-5",
messages: [{ role: "user", content: "Say hi in one sentence." }],
});
console.log(resp.choices[0].message.content);curl
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-haiku-4-5",
"messages": [{"role": "user", "content": "Say hi in one sentence."}]
}'如果收到响应,恭喜你,账户已启用。费用会在几秒内显示在
/app/usage 中。其他模态
同一个 SDK 也支持图像和视频。只要可能,端点名称均采用 OpenAI 的命名方式。
图像生成
可使用任意图像模型——Nano Banana、Nano Banana 2、Nano Banana Pro 和 GPT-Image-2。请参阅图像文档。
img = client.images.generate(
model="nano-banana",
prompt="a tiny red origami crane on a white desk",
size="1024x1024",
)
print(img.data[0].url)流式聊天
设置 stream=True。所有聊天模型均支持流式传输,包括完整的 Claude 和 GPT 系列。响应采用 OpenAI 标准格式的服务器发送事件。
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Tell me a 2-line haiku about CI/CD."}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)