Hướng dẫn thực tế dành cho các nhà phát triển Ý muốn sử dụng Claude API trong môi trường production. Chênh lệch giá so với Anthropic trực tiếp, thanh toán bằng phương thức của Ý, độ trễ từ Milan và Rome, GDPR và hóa đơn điện tử — mọi điều cần biết trước cuộc gọi đầu tiên.
Cuộc 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ỉ là thay đổi một dòng trong base_url. Trong Python:
from openai import OpenAI
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1", # cambia solo questa riga
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Presentati brevemente in italiano."}],
)
print(resp.choices[0].message.content)Trong 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: "Riassumi questo articolo in 3 punti." }],
});
console.log(resp.choices[0].message.content);Đăng ký miễn phí: bạn nạp từ $10, chỉ trả cho phần đã dùng (pay-as-you-go) và số dư không bao giờ hết hạn — quá đủ để thử 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 mô hình Claude trên Kunavo có giá thấp hơn 30% so với giá chính thức của Anthropic. Claude Sonnet 4.6 có giá trực tiếp là $3,00 cho đầu vào / $15,00 cho đầu ra trên mỗi triệu token — trên Kunavo: $2,10 / $10,50, tức thấp hơn 30%. Với prompt caching, việc đọc lại phần tiền tố ổn định được tính bằng 10% giá đầu vào, tức khoảng $0,21 cho mỗi triệu token. Tất cả mức giá đều ở /pricing.
Độ trễ từ Milan / Rome
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 quá trình bắt tay TLS, chứ không rút ngắn hành trình qua Đại Tây Dương: từ máy chủ cloud ở Milan (AWS Milan, OVH, Aruba), 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 mô hình. Gọi trực tiếp Anthropic đi qua đúng tuyến đó. Phản hồi streaming đến với cùng time-to-first-token như upstream — không buffering, không batching.
Thanh toán — thẻ, Apple Pay, Satispay
Chúng tôi sử dụng Stripe trực tiếp. Các phương thức có sẵn tại Ý:
- Thẻ: Visa, Mastercard, American Express, PostePay (qua mạng Visa)
- Apple Pay, Google Pay, Link (thanh toán một chạm)
- Satispay — xuất hiện khi trang thanh toán hiển thị bằng euro
Các khoản nạp được hiển thị bằng USD, nhưng Stripe chuyển đổi sang đơn vị tiền tệ của bạn trên trang thanh toán — Pix ở Brazil cũng hoạt động chính xác như vậy. Tuy nhiên, ghi nợ trực tiếp SEPA không nằm trong đó: tính năng này chưa được bật trên tài khoản của chúng tôi nên không bao giờ xuất hiện tại bước thanh toán. Mọi thẻ phát hành tại Ý đều hoạt động bình thường, bao gồm thẻ ghi nợ liên kết với tài khoản SEPA; nếu bạn thanh toán bằng đô la, ngân hàng của bạn sẽ thực hiện chuyển đổi.
Mức nạp tối thiểu $10 USD (~9 €). Đây không phải gói đăng ký mà là ví trả trước — số dư không bao giờ hết hạn.
VAT và hóa đơn điện tử
Trang thanh toán tiêu chuẩn không hiển thị VAT và không yêu cầu mã số thuế VAT; không có hóa đơn VAT nào được phát hành tự động. Các khoản nạp của bạn xuất hiện cùng ngày, số tiền và trạng thái trong bảng điều khiển thanh toán; nếu cần chứng từ cho kế toán, hãy viết tới contact@kunavo.com.
Hóa đơn điện tử gửi tới SDI (Sistema di Interscambio): hiện Kunavo chưa phát hành hóa đơn điện tử định dạng XML tới SDI của Ý. Nếu cần hóa đơn, hãy viết tới sales@kunavo.com.
GDPR 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), 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 snapshot mã hóa hằng ngày của volume. Chúng tôi chuyển các yêu cầu đến các API upstream (Anthropic, OpenAI, Google) — các nhà cung cấp này xử lý nội dung prompt theo điều khoản riêng của họ. Anthropic và Google cung cấp các tùy chọn Zero Data Retention cho khách hàng doanh nghiệp của họ, nhưng Kunavo không cung cấp định tuyến ZDR, thỏa thuận xử lý dữ liệu (DPA / Điều 28 GDPR) hay nơi lưu trú dữ liệu tại EU: các yêu cầu được xử lý tại Hoa Kỳ và chuyển đế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 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 Ý
Đội ngũ của chúng tôi trả lời email bằng tiếng Ý 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
- Hóa đơn VAT? Không tự động: trang thanh toán không hiển thị VAT và không yêu cầu mã số thuế VAT. Để nhận chứng từ: contact@kunavo.com.
- Hóa đơn điện tử tới SDI? Không được hỗ trợ.
- Ghi nợ trực tiếp SEPA? Không — ghi nợ trực tiếp SEPA chưa được bật trên tài khoản Stripe của chúng tôi. Thẻ ghi nợ liên kết với tài khoản SEPA vẫn hoạt động bình thường. Có thể tùy chọn bật nạp tiền tự động từ thẻ đã lưu hoặc Link (không thể tự động tính phí Satispay).
- DPA (Điều 28 GDPR)? Không: Kunavo không cung cấp DPA và các yêu cầu được xử lý tại Hoa Kỳ. Nếu cần, hãy ký trực tiếp với nhà cung cấp mô hình (Anthropic, OpenAI hoặc Google).
- Mô hình tiếng Ý (Minerva, v.v.)? 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ó câu hỏi từ Ý? Hãy viết trực tiếp tới contact@kunavo.com — chúng tôi trả lời bằng tiếng Ý.