文档

文档

快速入门

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)

接下来

  1. 身份验证 — API 密钥和 base URL 的完整参考。
  2. 聊天补全 — 参数、流式传输、工具调用和视觉能力。
  3. 账单 — 加价公式和余额账本的工作方式。
  4. 错误 — HTTP 状态码和重试策略。