Hướng dẫn thực tế dành cho các nhà phát triển muốn sử dụng Claude API từ Thổ Nhĩ Kỳ. Chênh lệch so với giá trực tiếp của Anthropic, việc sử dụng Visa/Mastercard và thẻ quốc tế, độ trễ từ Istanbul và Ankara, tỷ giá lira-USD và các lưu ý về tuân thủ KVKK — mọi điều bạn cần biết trước lệnh 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 đã sử dụng OpenAI SDK, việc chuyển đổi chỉ là thay một dòng base_url. Trong Python:
from openai import OpenAI
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1", # değişen tek satır bu
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Kendini Türkçe iki cümleyle tanıt."}],
)
print(resp.choices[0].message.content)Trong Node.js / TypeScript cũng hoàn toàn 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: "Bu makaleyi 3 madde halinde özetle." }],
});
console.log(resp.choices[0].message.content);Đăng ký miễn phí: nạp từ $10, chỉ trả tiền cho phần bạn sử dụng (pay-as-you-go) và số dư không bao giờ hết hạn — dư sức để kiểm thử toàn diện 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 thấp hơn 30% so với bảng giá chính thức của Anthropic, tùy model. Claude Sonnet 4.6 có giá trực tiếp là $3,00 input / $15,00 output trên mỗi triệu token — trên Kunavo là $2,10 / $10,50 (rẻ hơn 30%). Với prompt caching, việc đọc lại prefix cố định được tính bằng 10% giá input, tức khoảng $0,21 cho mỗi triệu token. Giá đầy đủ của tất cả model có tại /pricing.
Độ trễ từ Istanbul và Ankara
Kunavo chạy trong một khu vực US-East duy nhất (Ashburn, Virginia); phía trước có một anycast edge kết thúc TLS tại điểm gần bạn. Edge chỉ rút ngắn quá trình bắt tay TLS, không rút ngắn hành trình qua Đại Tây Dương: thời gian khứ hồi từ máy chủ đám mây ở Istanbul đến bờ Đông Hoa Kỳ được quyết định bởi khoảng cách vật lý và thời gian suy luận riêng của model. Truy cập trực tiếp Anthropic us-east-1 cũng đi qua cùng tuyến đường. Phản hồi streaming đến với cùng time-to-first-token như upstream — không buffering, không batching.
Phương thức thanh toán — thẻ Thổ Nhĩ Kỳ, thẻ quốc tế, Apple Pay và Google Pay
Chúng tôi sử dụng Stripe trực tiếp. Các phương thức phù hợp cho khách hàng tại Thổ Nhĩ Kỳ:
- Thẻ Visa và Mastercard của các ngân hàng Thổ Nhĩ Kỳ được mở thanh toán quốc tế
- American Express (các ngân hàng chấp nhận thanh toán quốc tế)
- Apple Pay, Google Pay (nếu đã cài đặt trên Chrome / Android), Link (thanh toán một chạm)
Lưu ý quan trọng: Thẻ của bạn phải được mở cho các giao dịch quốc tế. Một số ngân hàng Thổ Nhĩ Kỳ mặc định khóa thẻ cho giao dịch ở nước ngoài — bạn có thể cần yêu cầu ngân hàng bật quyền sử dụng quốc tế một lần hoặc vĩnh viễn.
Giá tính bằng USD; Stripe chuyển đổi sang TRY trong quá trình thanh toán. Tỷ giá của Stripe bao gồm phí chuyển đổi 2–4% do người mua trả; nếu thanh toán bằng USD thì không có khoản phí này (tài liệu Stripe Adaptive Pricing, được đọc vào ngày 2026-10-03). Không có thanh toán bằng chuyển khoản ngân hàng / EFT. Nạp tối thiểu $10 USD. Không phải gói đăng ký mà là ví trả trước — số dư không bao giờ hết hạn.
Chiến lược trước biến động của đồng lira Thổ Nhĩ Kỳ
Vì TRY đã biến động mạnh so với USD trong những năm gần đây, mức giá tính theo USD của Kunavo có thể khiến chi phí tăng trong một số giai đoạn. Ba cách tiếp cận thực tế:
- Nạp số lượng lớn: các khoản nạp từ $1.000 trở lên sẽ mở khóa tín dụng thưởng bổ sung (ví dụ: nạp $1.000 = tín dụng $1.200). Chi tiết tại /pricing.
- Sử dụng prompt caching: có thể tiết kiệm 70-90% chi phí input trong các kiến trúc agent có system prompt lặp lại. Hướng dẫn: phân tích chuyên sâu về prompt caching.
- Phân tầng model: Claude Haiku 4.5 cho tác vụ đơn giản (rẻ hơn 10 lần), Opus 4.7 cho tác vụ phức tạp. Chi tiết: hướng dẫn tối ưu chi phí.
KVKK và vị 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; 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 volume được snapshot và mã hóa hằng ngày. Chúng tôi định tuyế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ọ; tuy nhiên Kunavo không cung cấp định tuyến ZDR, thỏa thuận xử lý dữ liệu (DPA) hay nơi lưu trú dữ liệu tại Thổ Nhĩ Kỳ hoặc 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 thỏa thuận xử lý dữ liệu theo KVKK, ZDR hoặc nơi lưu trú dữ liệu trong nước, 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ợ tiếng Thổ Nhĩ Kỳ
Đội ngũ của chúng tôi trả lời các email tiếng Thổ Nhĩ Kỳ gửi tới contact@kunavo.com bằng tiếng Thổ Nhĩ Kỳ trong vòng một ngày làm việc.
Câu hỏi thường gặp
- Thẻ Thổ Nhĩ Kỳ của tôi bị từ chối, tôi phải làm gì? Hãy yêu cầu ngân hàng mở thanh toán quốc tế hoặc thử dùng Visa (Mastercard đôi khi gặp vấn đề với một số ngân hàng).
- Có thể thanh toán bằng TRY không? Không, giá được tính bằng USD. Stripe hiển thị TRY trong quá trình thanh toán nhưng đơn vị cơ sở vẫn là USD.
- Tuân thủ KVKK? Kunavo không cung cấp thỏa thuận xử lý dữ liệu và các yêu cầu được xử lý tại Hoa Kỳ. Nếu cần thỏa thuận như vậy, 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ó LLM Thổ Nhĩ Kỳ nội địa không? Hiện danh mục chưa có LLM Thổ Nhĩ Kỳ nội địa. Xem danh mục hiện tại tại /models; hãy đăng ký changelog.
Bạn đã sẵn sàng bắt đầu chưa? Đăng ký miễn phí, nạp từ $10 và thực hiện lần gọi Claude đầu tiên trong năm phút. Nếu có câu hỏi từ Thổ Nhĩ Kỳ, hãy liên hệ trực tiếp contact@kunavo.com — chúng tôi trả lời bằng tiếng Thổ Nhĩ Kỳ.