文件

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

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

開始 Quickstart 瀏覽 39 個模型

第一次呼叫

把 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="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Hello, Kunavo"}],
)
print(resp.choices[0].message.content)

參考文件

按主題瀏覽

起步

Quickstart

註冊、充值、調通第一次請求，全程不超過 5 分鐘。

鑑權

API Key、base URL、請求頭規範，以及 Key 輪換最佳實踐。

Claude API key

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

Gemini API key

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

計費

錢包充值、加價公式、流水賬本如何工作。

用量 API

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

錯誤碼

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

端點

Chat completions

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

Messages API

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

影象

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

影片

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

音樂

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

進階指南

Prompt 快取

Anthropic 重複 prompt 最高省 90% 輸入成本 —— cache_control、親和性路由、控制檯指標全套打通。

Ollama OpenAI API

Call Ollama's local OpenAI-compatible API — and point the same SDK at hosted Claude, Gemini and GPT.

從 OpenAI 遷移

即將上線

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

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