文件
快速入門
Kunavo 與 OpenAI Wire 相容。如果您已在使用 OpenAI SDK，只需變更基礎 URL。五分鐘內，從零開始呼叫您的第一個前沿模型。
Kunavo 是獨立且相容於 OpenAI 的 AI API 閘道：使用一組 API 金鑰和一筆隨用隨付餘額，即可呼叫 Claude、GPT 以及圖像、影片和音訊模型，無須為各家供應商個別註冊帳戶。 整個啟用流程分為四個步驟。前三個步驟只需進行一次。第四步——發出呼叫——只要替換 base_url 即可。
1. 建立帳戶
使用 Google 或電子郵件魔法連結，在 kunavo.com/app/login 註冊。採用隨用隨付制，最低儲值金額為 $10——餘額永不過期，請求失敗也絕不收費。
2. 建立 API 金鑰
在儀表板中開啟 /app/keys，然後點選 新增金鑰。金鑰開頭為 sk-kn-，且建立時只會顯示一次——請複製並妥善保存。
建議的安全做法：
- 每個專案／環境（開發、預備、正式環境）使用一組專屬金鑰。
- 發生安全事件時或每季輪替金鑰。
- 若透過 CI 執行指令碼呼叫，請為每組金鑰設定每月支出上限。
3. 為錢包儲值
前往 /app/billing，並透過 Stripe Checkout 儲值。Stripe 覆蓋的所有地區均提供卡片；除印度外的所有地區均提供 Apple Pay、Google Pay 和 Link；另依國家顯示當地付款方式——例如美國的 ACH、巴西的 Pix、印度的 UPI、韓國的 KakaoPay、荷蘭的 iDEAL、波蘭的 BLIK（完整清單位於 billing reference；不提供 PayPal 和 SEPA Direct Debit）。儲值金額最低為 $10，足以用真實金鑰試用每個模型，且餘額永不失效。
- 隨用隨付：使用費用會即時從錢包扣除，無需訂閱。
- 適用大量儲值獎勵：$100 → +$10、$1,000 → +$200、$5,000 → +$1,250。
- 信用卡帳單上的商店名稱：
KUNAVO.COM* TOPUP。
4. 發出您的第一個呼叫
從模型目錄中選擇任何已啟用的模型。以下範例使用快速、低成本的 claude-haiku-4-5 聊天呼叫，讓您確認設定是否正確。
Python（OpenAI SDK）
openai Python 套件（v1 以上）可直接使用——只要將 base_url 指向 Kunavo 即可。
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
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)