文件

5 分鐘，從註冊到第一行回應。

Kunavo 完全遵循 OpenAI 通訊協定。如果你已經在用 OpenAI SDK，遷移成本就是改一行 base_url —— 僅此而已。

開始 Quickstart 瀏覽 35 個模型

第一次呼叫

把 SDK 指向 Kunavo。

OpenAI Python SDK 不用換。改 base_url、貼一個 /app/keys 裡拿到的 API Key —— 你原來的 chat / image / embedding 程式碼就能直接呼叫任何前沿模型。

first_call.py

from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

resp = client.chat.completions.create(
    model="claude-haiku-4-5",
    messages=[{"role": "user", "content": "Hello, Kunavo"}],
)
print(resp.choices[0].message.content)

參考文件

按主題瀏覽

起步

快速開始

註冊、儲值、完成第一次請求，全程不超過 5 分鐘。

工具串接

53 個客戶端的設定 — Claude Code、Cline、Kilo Code、Roo Code、Codex CLI、opencode、CC Switch、SillyTavern、Janitor AI 等：base URL、金鑰與模型名稱。

身分驗證

API Key、base URL、請求標頭規範，以及 Key 輪替最佳做法。

Claude API 金鑰

取得 Claude API Key，用 OpenAI SDK 或原生 Messages API 呼叫 Claude，以及 Key 錯誤時回傳的錯誤碼。

Gemini API 金鑰

從 Google AI Studio 取得 Gemini API Key，用 OpenAI SDK 呼叫，並避免把 Key 打進前端 bundle。

計費

錢包儲值、加價公式、帳本如何運作。

用量 API

GET /v1/usage —— 按日（或按小時）取得目前 API key 自己的 token 用量與費用。

錯誤碼

HTTP 狀態碼、錯誤回應結構，以及不燒錢的重試策略。

端點

聊天補全

OpenAI 相容的 /v1/chat/completions，含 streaming、tools、vision、reasoning。

訊息 API

原生 Anthropic Messages API —— cache_control、tools、thinking 直通 Claude。

影像

文生圖與圖生圖（i2i）端點 —— Nano Banana 與 GPT-Image-2。

影片

Veo 3.1 —— Fast、Quality、Lite。長任務 API。

音樂

Suno V5 —— 文字生成音樂，支援人聲、歌詞與風格。非同步任務 API。

進階指南

Prompt 快取

Anthropic 重複 prompt 最高省 90% 輸入成本 —— cache_control、親和性路由、控制台指標如何串在一起。

Ollama OpenAI API

呼叫 Ollama 的本機 OpenAI 相容 API，並使用同一個 SDK 連接託管版 Claude 和 GPT。

從 OpenAI 遷移

即將上線

從 OpenAI / Anthropic / Google 直連無縫遷移的指南。

5 分鐘， 從註冊到第一行回應。