Tài liệu

Từ lúc đăng ký đến token đầu tiên — trong năm phút.

Kunavo tuân thủ giao thức wire của OpenAI. Nếu bạn đã dùng SDK OpenAI, việc chuyển đổi chỉ là thay một dòng ở base_url. Thật đấy.

Bắt đầu quickstart Khám phá 31 mô hình

Lượt gọi đầu tiên

Trỏ SDK của bạn tới Kunavo.

SDK Python của OpenAI chạy mà không cần thay đổi. Thiết lập base_url và API key của bạn từ /app/keys và mã chat/image/embedding hiện có của bạn vẫn chạy với bất kỳ mô hình tiên phong nào.

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)

Tham khảo

Chọn một chủ đề

Bắt đầu

Quickstart

Từ lúc đăng ký đến lượt gọi API đầu tiên trong chưa đầy 5 phút.

Xác thực

API key, base URL, quy ước header và thực hành tốt nhất khi xoay vòng key.

Claude API key

Lấy Claude API key, gọi Claude bằng OpenAI SDK hoặc Messages API gốc, và các mã lỗi khi key không hợp lệ.

Gemini API key

Lấy Gemini API key từ Google AI Studio hoặc Kunavo, gọi bằng OpenAI SDK, và giữ nó ngoài bundle phía client.

Thanh toán

Nạp tiền vào ví, công thức markup và cách hoạt động của sổ cái tín dụng.

API mức dùng

GET /v1/usage — kiểm tra mức dùng token hàng ngày và chi phí của API key của bạn.

Lỗi

Mã HTTP, định dạng payload lỗi và chiến lược retry mà không lãng phí ngân sách.

Endpoint

Chat completions

/v1/chat/completions tương thích OpenAI với streaming, tools, vision và reasoning.

Messages API

Messages API native của Anthropic — truyền cache_control, tools và thinking trực tiếp đến Claude.

Hình ảnh

Văn bản-sang-hình ảnh và chỉnh sửa hình ảnh (i2i) — Nano Banana và GPT-Image-2.

Video

Veo 3 — Fast, Quality, Lite. API cho các tác vụ kéo dài.

Music

Suno V5 — text-to-music with vocals, lyrics and styles. Async task API.

Hướng dẫn

Prompt caching

Tiết kiệm 90% chi phí input của Anthropic trên các prompt lặp lại — cách cache_control, affinity routing và số liệu dashboard kết hợp với nhau.

Ollama OpenAI API

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

Chuyển từ OpenAI

Sắp ra mắt

Hướng dẫn drop-in để chuyển từ OpenAI, Anthropic và Google trực tiếp.