文档

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

鉴权

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 打进前端包。

计费

钱包充值、加价公式、流水账本如何工作。

用量 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 分钟， 从注册到第一行返回。