文档

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)

参考文档

按主题浏览

起步

快速开始

工具接入

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

计费

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

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