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

Nhập môn Claude API cho nhà phát triển Nhật Bản — giá, độ trễ, thanh toán JCB đầy đủ

Hướng dẫn thực tế khi sử dụng Claude API từ Tokyo. Chênh lệch chi phí so với Anthropic chính thức, độ trễ từ Tokyo, hỗ trợ JCB / Apple Pay / Google Pay, mức tiêu thụ token tiếng Nhật và thông tin doanh nghiệp theo Luật giao dịch thương mại đặc định.

Tôi sẽ tổng hợp và trả lời các câu hỏi thường gặp về cách gọi Claude API từ Nhật Bản. Nội dung bao quát mọi điểm mà nhà phát triển muốn kiểm tra đầu tiên: chênh lệch giá so với Anthropic chính thức, thanh toán bằng thẻ JCB, độ trễ đo được từ Tokyo và nơi tìm thông tin doanh nghiệp theo Luật giao dịch thương mại đặc định.

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

Kunavo tương thích với giao thức truyền dữ liệu của OpenAI, vì vậy nếu bạn đã sử dụng OpenAI SDK thì việc chuyển đổi chỉ cần thay đổi một dòng cấu hình base_url. Với 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í. Bạn có thể nạp tiền từ $10 và sử dụng mô hình theo hình thức tính phí theo mức sử dụng (pay-as-you-go); số dư không hết hạn. Đủ để dùng thử Claude Opus 4.7, Sonnet 4.6 và Haiku 4.5.

Chênh lệch giá so với Anthropic chính thức

Các mô hình Claude trên Kunavo được 30% giảm giá so với giá chính thức của Anthropic (tùy mô hình). Claude Sonnet 4.6 có giá input $3,00, output $15,00 (trên mỗi triệu token) tại Anthropic chính thức, nhưng trên Kunavo là input $2,10, output $10,50 (30% giảm giá). Nếu sử dụng prompt cache, cache read có giá bằng 10% giá input — tức là có thể đọc lại với chi phí thực tế $0,21/1 triệu token. Đơn giá của tất cả mô hình được đăng tại /pricing.

Độ trễ từ Tokyo

Điểm vào của Kunavo sử dụng mạng edge anycast và TLS được kết thúc tại nút gần bạn. Bản thân gateway chạy ở một khu vực US-East duy nhất (Ashburn, Virginia). Edge rút ngắn thời gian round-trip của quá trình bắt tay TLS, chứ không rút ngắn đoạn vượt Thái Bình Dương — khi gọi từ Tokyo, thời gian round-trip chủ yếu do khoảng cách vật lý giữa Tokyo và miền Đông Hoa Kỳ quyết định, cộng thêm thời gian suy luận của chính mô hình. Gọi trực tiếp us-east-1 của Anthropic cũng đi qua cùng đoạn đường. Streaming được triển khai dưới dạng SSE passthrough để Time-to-first-token tương đương với upstream.

Phương thức thanh toán — JCB, Apple Pay, Google Pay

Thanh toán tích hợp Stripe. Các phương thức khách hàng Nhật Bản có thể sử dụng:

  • Thẻ tín dụng / thẻ ghi nợ: JCB, Visa, Mastercard, American Express
  • Apple Pay, Google Pay (nếu đã thiết lập trên Chrome / Android), Link (thanh toán một chạm)

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

Thông tin theo Luật giao dịch thương mại đặc định

Thông tin doanh nghiệp, chính sách hoàn tiền, giờ làm việc và các thông tin khác dành cho khách hàng tại Nhật Bản được tổng hợp tại /legal/tokutei-shoutorihiki. Chính sách cơ bản về hoàn tiền là: “Số dư đã thanh toán nhưng chưa sử dụng có thể được hoàn về phương thức thanh toán ban đầu bất cứ lúc nào, kể cả khi không đóng tài khoản, sau khi khấu trừ phí thanh toán tương ứng với số tiền hoàn; số dư đã sử dụng và credit thưởng hoặc khuyến mại không được hoàn.” Chúng tôi tuyệt đối không tính phí đối với các yêu cầu thất bại (4xx/5xx).

Lựa chọn các mô hình thường dùng

  • Claude Opus 4.7 — năng lực suy luận mạnh nhất. Dành cho các tác vụ phức tạp cần hiểu sắc thái tiếng Nhật, 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. Đây là mô hình được các startup Nhật Bản sử dụng nhiều nhất. Có thể dùng làm mô hình chính cho chatbot, tạo nội dung và agent.
  • Claude Haiku 4.5 — nhanh và rẻ. Phù hợp cho tác vụ phân loại, lọc, tóm tắt đơn giản và bước tiền xử lý của agent. Chi phí khoảng một phần mười Sonnet.

Lưu ý đặc thù của tiếng Nhật

Claude cho chất lượng đầu vào và đầu ra tiếng Nhật tương đương tiếng Anh, nhưng mức tiêu thụ token có xu hướng cao hơn khoảng 2 lần đối với tiếng Nhật (khoảng 0,5–0,8 token mỗi ký tự, trong khi tiếng Anh khoảng 0,25 token/ký tự). Hãy tính đến điểm này khi tính chi phí.

Cách phân biệt việc dùng kính ngữ và lối nói thân mật nên được chỉ định rõ ràng trong system prompt để bảo đảm hiệu quả:

“Bạn là nhân viên hỗ trợ khách hàng tại Nhật Bản. Luôn trả lời bằng ngôn ngữ lịch sự (dạng desu/masu) và giữ thái độ lễ phép với khách hàng.”

Bắt đầu

Nếu đến đây bạn không còn điều gì thắc mắc:

  1. Đăng ký miễn phí tại /app/signup (nạp từ $10, tính phí theo mức sử dụng)
  2. Phát hành khóa API tại /app/keys
  3. Thực hiện cuộc gọi đầu tiên bằng đoạn mã trong /docs/quickstart

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