Hướng dẫn thực tế dành cho các nhà phát triển Brazil muốn chạy Claude API trong môi trường sản xuất. Chênh lệch giá so với Anthropic trực tiếp, thanh toán bằng Pix và thẻ, độ trễ từ São Paulo, LGPD và hóa đơn — mọi điều quan trọng trước lần gọi đầu tiên.
Lần gọi đầu tiên trong 5 giây
Kunavo tương thích với giao thức wire của OpenAI. Nếu mã của bạn đã dùng SDK OpenAI, việc chuyển đổi chỉ cần thay đổi một dòng trong base_url. Với Python:
from openai import OpenAI
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1", # só essa linha muda
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Se apresente brevemente em português."}],
)
print(resp.choices[0].message.content)Với Node.js / TypeScript cũng tương tự:
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-opus-4-7",
messages: [{ role: "user", content: "Resuma este artigo em 3 tópicos." }],
});
console.log(resp.choices[0].message.content);Đăng ký miễn phí: bạn nạp từ $10, chỉ trả tiền cho phần đã dùng (pay-as-you-go) và số dư không bao giờ hết hạn — đủ để thử nghiệm chuyên sâu Claude Opus 4.7, Sonnet 4.6 và Haiku 4.5.
Chênh lệch giá so với Anthropic trực tiếp
Các model Claude trên Kunavo có giá thấp hơn 30% so với giá chính thức của Anthropic, tùy model. Claude Sonnet 4.6 có giá trực tiếp là $3,00 cho input / $15,00 cho output trên 1 M token — trên Kunavo: $2,10 / $10,50 (30% thấp hơn). Với prompt caching, việc đọc lại prefix ổn định được tính bằng 10% giá input, tức $0,21 trên 1 M token. Giá đầy đủ cho từng model tại /pricing.
Độ trễ từ São Paulo / Rio
Kunavo chạy trong một khu vực US-East duy nhất (Ashburn, Virginia), phía sau một edge anycast kết thúc TLS gần bạn. Edge rút ngắn thời gian bắt tay TLS, không phải quãng đường đến Hoa Kỳ: từ São Paulo, Rio hoặc Brasília, thời gian khứ hồi chủ yếu bị chi phối bởi khoảng cách vật lý đến bờ Đông Hoa Kỳ, cộng với thời gian suy luận của chính model. Gọi trực tiếp Anthropic từ Brazil đi qua đúng tuyến đường đó.
Các phản hồi streaming đến với cùng time-to-first-token như upstream — không buffering, không batching. Đối với các tác vụ nhạy cảm về độ trễ (chăm sóc khách hàng theo thời gian thực, tác nhân hội thoại), điều này tạo ra khác biệt lớn.
Thanh toán — Pix và thẻ quốc tế
Chúng tôi sử dụng Stripe trực tiếp. Đối với khách hàng tại Brazil:
- Pix (thanh toán tức thì, số tiền hiển thị bằng đồng real) — không yêu cầu thẻ tín dụng quốc tế
- Thẻ quốc tế: Visa, Mastercard, American Express
- Apple Pay, Google Pay và Link
Boleto không khả dụng, và các mạng lưới nội địa Elo và Hipercard cũng vậy; chúng không xuất hiện trong trang thanh toán của chúng tôi. Thẻ phát hành tại Brazil cần được bật cho giao dịch mua hàng quốc tế — nếu bị từ chối, hãy kiểm tra điều này trong ứng dụng ngân hàng hoặc thanh toán bằng Pix, vì Pix không phụ thuộc vào điều đó.
Giá được niêm yết bằng USD; Stripe chuyển đổi sang BRL tại bước thanh toán. Tỷ giá sử dụng tỷ giá hối đoái của Stripe tại thời điểm đó, đã bao gồm phí chuyển đổi 2–4% do người mua trả (theo tài liệu Adaptive Pricing của Stripe, được đọc vào ngày 2026-10-03). Nạp tối thiểu $10 USD. Không có gói đăng ký — đây là ví trả trước, số dư không bao giờ hết hạn.
IOF, thuế và hóa đơn
Các giao dịch bằng thẻ tín dụng quốc tế chịu IOF (hiện là 3,5% — hãy kiểm tra mức hiện hành), Pix cũng vậy: theo Stripe, IOF được áp dụng khi khách hàng ở Brazil thanh toán cho một công ty nước ngoài và khoản thuế này được cộng vào số tiền thanh toán, hiển thị trong ứng dụng ngân hàng. Hướng dẫn đầy đủ về cách nạp tiền bằng Pix có trong hướng dẫn thanh toán API bằng Pix. Kunavo không phát hành hóa đơn thuế của Brazil cũng như hóa đơn thanh toán: trang thanh toán không tạo chứng từ thuế. Lịch sử nạp tiền, gồm ngày, số tiền và trạng thái, có trong bảng điều khiển thanh toán của bạn; nếu cần chứng từ cho kế toán, hãy viết thư đến contact@kunavo.com.
LGPD và nơi lưu trữ dữ liệu
Logic định tuyến chạy trên gateway, tại khu vực US-East duy nhất (Ashburn), chứ không chạy trên edge anycast; edge anycast chỉ kết thúc TLS. Dữ liệu thanh toán và tài khoản được lưu trữ trong một cơ sở dữ liệu chính duy nhất, với các snapshot mã hóa hằng ngày của volume. Chúng tôi truyền các request đến các nhà cung cấp upstream — cơ chế chuyển đổi dự phòng chỉ thay đổi nhà cung cấp, không bao giờ thay đổi mô hình — và các nhà cung cấp này xử lý nội dung prompt theo điều khoản riêng của họ. Kunavo không cung cấp thỏa thuận xử lý dữ liệu (DPA), Zero Data Retention hay nơi lưu trú dữ liệu ngoài Hoa Kỳ: các request được xử lý tại Hoa Kỳ và chuyển tiếp đến các nhà cung cấp upstream. Nếu nhóm của bạn cần DPA, ZDR hoặc nơi lưu trú dữ liệu tại Brazil hay EU, hãy ký hợp đồng trực tiếp với nhà cung cấp mô hình (điều khoản doanh nghiệp của Anthropic, OpenAI hoặc Google).
Hỗ trợ bằng tiếng Bồ Đào Nha
Đội ngũ của chúng tôi trả lời email bằng tiếng Bồ Đào Nha gửi tới contact@kunavo.com trong vòng một ngày làm việc.
Câu hỏi thường gặp
- Pix có hoạt động không? Có, thông qua bước thanh toán Stripe. Chọn "Pix" làm phương thức thanh toán.
- Tôi có phải trả IOF không? Chỉ khi dùng thẻ tín dụng quốc tế. Pix thì không.
- Hóa đơn thuế bằng BRL? Không — Kunavo không phát hành NF-e hay hóa đơn. Để nhận chứng từ nạp tiền, hãy viết email tới contact@kunavo.com.
- Tuân thủ LGPD và DPA? Kunavo không cung cấp DPA và các request được xử lý tại Hoa Kỳ. Nếu cần, hãy ký hợp đồng trực tiếp với nhà cung cấp mô hình (Anthropic, OpenAI hoặc Google).
- Có model Brazil / Sabiá không? Chưa có trong danh mục — xem /models và đăng ký changelog.
Sẵn sàng bắt đầu? Đăng ký miễn phí, nạp từ $10 và thực hiện cuộc gọi Claude đầu tiên trong năm phút. Câu hỏi từ Brazil? Hãy viết trực tiếp tới contact@kunavo.com — chúng tôi trả lời bằng tiếng Bồ Đào Nha.