Quay lại blog
Hướng dẫn·24 tháng 5, 2026·Đọc 5 phút

Bắt đầu với Claude API tại Hàn Quốc — chuyển từ OpenAI SDK, độ trễ Seoul, token tiếng Hàn

Hướng dẫn bắt đầu Claude API cho nhà phát triển Hàn Quốc: cách chuyển từ OpenAI SDK chỉ bằng một dòng base_url, độ trễ phát sinh khi gọi từ Seoul, mức tiêu thụ token tiếng Hàn và lựa chọn model. Giá và phương thức thanh toán theo từng model được tổng hợp riêng trong phần giá và thanh toán Claude API.

Bài viết trả lời một lần các câu hỏi mà nhà phát triển sử dụng Claude API tại Hàn Quốc thường hỏi nhất: giá so với trụ sở Anthropic, độ trễ đo thực tế từ Seoul, khả năng thanh toán bằng thẻ nội địa và cách di chuyển từ OpenAI SDK chỉ bằng một thay đổi dòng.

Lệnh gọi đầu tiên trong 5 giây

Kunavo tương thích 100% với giao thức dây OpenAI. Nếu đang sử dụng OpenAI SDK, chi phí di chuyển chỉ là thay đổi một dòng base_url. Ví dụ Python:

quickstart.py
from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",  # 이 한 줄만 바꾸면 끝
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "한국어로 인사해주세요"}],
)
print(resp.choices[0].message.content)

Node.js / TypeScript cũng tương tự:

quickstart.mjs
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: "서울 오늘 날씨 알려줘" }],
});
console.log(resp.choices[0].message.content);

Đăng ký miễn phí, nạp tiền từ $10 và chỉ trả cho phần đã dùng theo mô hình pay-as-you-go; số dư không hết hạn. Bạn có thể kiểm thử đầy đủ Claude Opus 4.7, Sonnet 4.6 và Haiku 4.5. Với cùng một khóa tương thích OpenAI, bạn có thể gọi không chỉ Claude mà còn Gemini, GPT và các model hình ảnh/video.

Chênh lệch giá so với trụ sở — chi phí Claude API

Kunavo cung cấp các model Claude với giá rẻ hơn 30% so với giá chính thức của Anthropic. Claude Sonnet 4.6 tại trụ sở có giá đầu vào $3,00, đầu ra $15,00 (trên mỗi một triệu token), còn trên Kunavo được tính đầu vào $2,10, đầu ra $10,50 (giảm khoảng 30%). Nếu sử dụng bộ nhớ đệm prompt, lượt đọc bộ nhớ đệm chỉ bằng 10% giá đầu vào — tức có thể đọc lại với chi phí thực tế $0,21/một triệu token. Xem đơn giá đầy đủ theo model và phương thức thanh toán tại tổng hợp giá và thanh toán Claude API và trang giá.

Độ trễ từ Seoul

Cổng vào của Kunavo là mạng biên anycast, còn TLS được kết thúc tại nút gần nhất. Gateway thực tế chạy trong một region US-East duy nhất (Ashburn, Virginia). Edge chỉ rút ngắn thời gian khứ hồi của handshake TLS, không rút ngắn chặng vượt Thái Bình Dương — khi gọi từ Seoul, thời gian khứ hồi bị chi phối bởi khoảng cách vật lý giữa Seoul và miền Đông Hoa Kỳ, cộng thêm thời gian suy luận của chính model. Gọi trực tiếp us-east-1 của Anthropic cũng đi qua cùng chặng đó. Streaming được triển khai bằng SSE passthrough nên Time-to-first-token giống upstream.

Thanh toán — thẻ nội địa, KakaoPay?

Thanh toán được xử lý qua Stripe. Các phương thức khách hàng Hàn Quốc có thể sử dụng:

  • Thẻ tín dụng / thẻ ghi nợ: Visa, Mastercard, American Express, JCB
  • Apple Pay, Google Pay (nếu đã thiết lập trên Chrome·Android), Link (thanh toán một chạm)
  • Khi trang thanh toán hiển thị won Hàn Quốc: KakaoPay, Naver Pay, PAYCO, Samsung Pay, thẻ nội địa

Giá được tính bằng đô la Mỹ ($USD), và Stripe tự động quy đổi sang won Hàn Quốc tại thời điểm thanh toán. Tỷ giá này bao gồm phí chuyển đổi 2–4% do người mua chịu; phí này không áp dụng khi thanh toán bằng đô la Mỹ (tài liệu Stripe Adaptive Pricing, kiểm tra ngày 2026-10-03). Số tiền nạp tối thiểu là $10 USD (khoảng 14.000 won). Đây là hình thức ví trả trước thay vì gói đăng ký, nên số dư chưa sử dụng không hết hạn.

KakaoPay xuất hiện trên trang thanh toán như một phương thức nạp tiền Kunavo, còn Toss không được hỗ trợ. KakaoPay, Naver Pay, PAYCO, Samsung Pay và thẻ nội địa chỉ xuất hiện khi trang thanh toán hiển thị won Hàn Quốc; theo phương thức này, thẻ nội địa không cần bật thanh toán quốc tế. Khi thanh toán bằng đô la, cần thẻ có thể thanh toán quốc tế (nếu đang bật chặn thanh toán quốc tế, cần tắt chặn trong ứng dụng của công ty phát hành thẻ). Các phương thức này dùng để nạp số dư Kunavo, không phải để thanh toán trực tiếp cho Anthropic.

Chi phí token khi sử dụng tiếng Hàn

Claude cho chất lượng tương đương tiếng Anh khi xử lý đầu vào và đầu ra tiếng Hàn. Tuy nhiên, tiếng Hàn tiêu thụ nhiều hơn tiếng Anh khoảng 1,5–2 lần token (khoảng 0,5–0,7 token mỗi ký tự). Hãy tính đến điều này khi tính chi phí.

Cách chắc chắn nhất để phân biệt văn phong kính ngữ và thân mật là ghi rõ trong system prompt:

“Bạn là nhân viên hỗ trợ khách hàng tại Hàn Quốc. Mọi câu trả lời bắt buộc phải được viết bằng văn phong kính ngữ (-습니다/-입니다), đồng thời phản hồi khách hàng một cách lịch sự và thân thiện.”

Hướng dẫn chọn model

  • Claude Opus 4.7 — năng lực suy luận mạnh nhất. Phù hợp với các tác vụ phức tạp cần hiểu sắc thái tiếng Hàn, tóm tắt ngữ cảnh dài và tạo mã.
  • Claude Sonnet 4.6 — cân bằng giữa giá và năng lực. Là model được các startup Hàn Quốc sử dụng nhiều nhất. Phù hợp làm model chính cho chatbot, tạo nội dung và agent.
  • Claude Haiku 4.5 — nhanh và rẻ. Dùng cho phân loại, lọc, tóm tắt đơn giản và tiền xử lý cho agent. Chi phí khoảng 1/10 Sonnet.

Các bước tiếp theo

  1. Đăng ký miễn phí — nạp từ $10, thanh toán theo mức sử dụng, số dư không hết hạn
  2. Tạo khóa API tương thích với OpenAI — chỉ cần đổi base_url là SDK OpenAI hiện có hoạt động nguyên trạng
  3. Thực hiện lệnh gọi đầu tiên bằng Chat completions — Claude, Gemini và GPT dùng chung một endpoint
  4. Xem giá API Claude · Tổng hợp phương thức thanh toán · So sánh các lựa chọn thay thế OpenRouter

Vui lòng gửi câu hỏi đến contact@kunavo.com. Chúng tôi sẽ trả lời trong vòng 1 ngày làm việc.

Bài phân tích chuyên sâu liên quan