Bắt đầu nhanh

Kunavo là cổng API AI độc lập, tương thích với OpenAI: một khóa API và một số dư thanh toán theo mức sử dụng cho phép truy cập Claude, GPT cùng các mô hình hình ảnh, video và âm thanh mà không cần tài khoản riêng cho từng nhà cung cấp. Toàn bộ quy trình làm quen gồm bốn bước. Ba bước đầu chỉ cần thực hiện một lần. Bước thứ tư — thực hiện lệnh gọi — chỉ cần thay base_url.

1. Tạo tài khoản

Đăng ký tại kunavo.com/app/login bằng Google hoặc liên kết đăng nhập một lần gửi qua email. Dịch vụ tính phí theo mức sử dụng và bắt đầu từ khoản nạp 10 USD — số dư không bao giờ hết hạn và các yêu cầu thất bại không bao giờ bị tính phí.

2. Tạo khóa API

Mở /app/keys trong bảng điều khiển rồi nhấp Khóa mới. Khóa bắt đầu bằng sk-kn- và được hiển thị chỉ một lần khi tạo — hãy sao chép và lưu trữ an toàn.

Thực hành bảo mật được khuyến nghị:

• Dùng một khóa cho mỗi dự án / môi trường (dev, staging, prod).
• Xoay vòng khóa khi xảy ra sự cố hoặc mỗi quý.
• Đặt giới hạn chi tiêu hàng tháng cho từng khóa nếu bạn gọi API bằng tập lệnh từ CI.

3. Nạp tiền vào ví

Truy cập /app/billing và nạp tiền qua Stripe Checkout. Thẻ được cung cấp ở mọi nơi Stripe hoạt động, còn Apple Pay, Google Pay và Link ở mọi nơi ngoại trừ Ấn Độ; các phương thức nội địa xuất hiện theo quốc gia — ví dụ ACH tại Hoa Kỳ, Pix tại Brazil, UPI tại Ấn Độ, KakaoPay tại Hàn Quốc, iDEAL tại Hà Lan, BLIK tại Ba Lan (danh sách đầy đủ có trong tài liệu tham khảo về thanh toán; không cung cấp PayPal và ghi nợ trực tiếp SEPA). Mức nạp bắt đầu từ $10 — đủ để thử mọi mô hình bằng một khóa thực — và số dư không bao giờ hết hạn.

• Thanh toán theo mức sử dụng: phí sử dụng được trừ khỏi ví theo thời gian thực, không cần đăng ký thuê bao.
• Có thưởng theo số lượng: $100 → +$10, $1.000 → +$200, $5.000 → +$1.250.
• Nội dung hiển thị trên sao kê thẻ: KUNAVO.COM* TOPUP.

4. Thực hiện lệnh gọi đầu tiên

Chọn bất kỳ mô hình nào đang bật từ danh mục. Ví dụ bên dưới: một lệnh gọi trò chuyện claude-haiku-4-5 nhanh, chi phí thấp để bạn kiểm tra kết nối.

Python (OpenAI SDK)

Gói Python openai (v1 trở lên) hoạt động ngay mà không cần cấu hình thêm — chỉ cần trỏ base_url tới Kunavo.

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-haiku-4-5",
  messages: [{ role: "user", content: "Say hi in one sentence." }],
});
console.log(resp.choices[0].message.content);

curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [{"role": "user", "content": "Say hi in one sentence."}]
  }'

Các phương thức khác

Cùng SDK đó cũng xử lý hình ảnh và video. Khi có thể, các điểm cuối sử dụng tên theo chuẩn OpenAI.

Tạo hình ảnh

Dùng bất kỳ mô hình tạo ảnh nào — Nano Banana, Nano Banana 2, Nano Banana Pro và GPT-Image-2. Xem tài liệu về hình ảnh.

img = client.images.generate(
    model="nano-banana",
    prompt="a tiny red origami crane on a white desk",
    size="1024x1024",
)
print(img.data[0].url)

Trò chuyện truyền phát trực tuyến

Đặt stream=True. Truyền phát trực tuyến hoạt động với mọi mô hình trò chuyện — toàn bộ dòng Claude và GPT. Phản hồi là luồng sự kiện do máy chủ gửi theo định dạng chuẩn của OpenAI.

stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Tell me a 2-line haiku about CI/CD."}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Tiếp theo nên xem gì

1. Xác thực — tài liệu tham khảo đầy đủ về khóa API + URL cơ sở.
2. Hoàn tất trò chuyện — tham số, truyền phát trực tuyến, gọi công cụ, thị giác.
3. Lập hóa đơn — cách hoạt động của công thức phụ phí và sổ cái tín dụng.
4. Lỗi — mã HTTP và chiến lược thử lại.