Cách lấy khóa API Claude — qua kênh chính thức và qua gateway

Có hai cách để nhận khóa API Claude. Một là nhận trực tiếp từ bảng điều khiển Anthropic; cách còn lại là nhận từ một cổng cung cấp endpoint tương thích với Anthropic. Cả hai đều gọi cùng mô hình Claude; trong mã, chỉ base URL và chuỗi khóa là khác nhau.

Dưới đây, chúng tôi trình bày cả hai phương thức và đồng thời đề cập các vấn đề thanh toán thường gặp ở Hàn Quốc.

Phương thức 1 — Nhận trực tiếp từ bảng điều khiển Anthropic

Tạo tài khoản Anthropic, đăng ký phương thức thanh toán rồi tạo khóa API trong bảng điều khiển. Khóa theo phương thức này được tính phí theo giá niêm yết của Anthropic; ưu điểm là nhận được tài liệu chính thức và hỗ trợ chính thức.

Điểm thường gây trở ngại ở Hàn Quốc phần lớn nằm ở bước thanh toán. Thẻ bị chặn thanh toán quốc tế sẽ không thể đăng ký; cho phép thanh toán quốc tế trong ứng dụng của đơn vị phát hành thẻ rồi thử lại thường giải quyết được vấn đề.

Phương thức 2 — Khóa cổng

Đây là cách gọi mô hình Claude mà không cần tài khoản Anthropic. Kunavo cung cấp cả Anthropic Messages API và API tương thích với OpenAI, nên bạn chỉ cần thay base URL và khóa trong mã hiện có.

Phương thức này cũng ít bị chặn hơn ở bước thanh toán. Khi trang thanh toán hiển thị won Hàn Quốc, hình thức nạp trả trước Kunavo cung cấp KakaoPay, Naver Pay, PAYCO, Samsung Pay và thẻ nội địa chưa bật thanh toán quốc tế làm phương thức thanh toán (Toss Pay không được cung cấp). Số dư đã nạp được dùng cho các lệnh gọi API Claude, không phải để thanh toán phí đăng ký Anthropic.

# OpenAI SDK를 그대로 쓰면서 base_url만 바꾸는 방식.
# 코드에서 바뀌는 줄은 base_url 한 줄뿐입니다.
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key="sk-kn-...",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(resp.choices[0].message.content)

Nếu mã của bạn dùng định dạng gốc của Anthropic, hãy đặt base URL thành https://api.kunavo.com — trong trường hợp này, không thêm /v1. Sự khác biệt giữa hai định dạng được trình bày trong tài liệu ANTHROPIC_BASE_URL.

Mức giá

Mức giá được đọc từ danh mục khi trang được kết xuất, nên tài liệu này không thể lệch với số tiền thực tế bị tính. Nội dung chi tiết hơn về phương thức thanh toán và thẻ trong nước được trình bày tại Giá và thanh toán API Claude.

Kiểm tra trong 30 giây sau khi nhận khóa

Sau khi nhận khóa, hãy gọi thử ngay một lần. Kiểm tra trước như vậy sẽ giúp bạn nhanh chóng phân biệt các lỗi phát sinh sau đó có phải do khóa hay không.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 200이 오면 키는 정상입니다.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,
       "messages":[{"role":"user","content":"안녕하세요"}]}'

Nếu nhận được 200, khóa hoạt động bình thường. Nếu là 401, phần lớn nguyên nhân là loại tiêu đề xác thực không khớp; 429 là giới hạn tốc độ; 529 là tình trạng quá tải của thượng nguồn và không liên quan đến khóa. Cách xử lý từng lỗi được trình bày trong tổng hợp lỗi Claude Code.

Phân chia khóa

An toàn hơn là chia khóa theo mục đích sử dụng. Nếu thu hồi một khóa, các khóa còn lại không bị ảnh hưởng; bạn cũng có thể đặt giới hạn sử dụng hằng tháng cho từng khóa. Giới hạn được kiểm tra trước khi yêu cầu thực thi và đặt lại vào đầu mỗi tháng, nên đặc biệt hữu ích khi cấp khóa cho tác nhân không có người giám sát.

Câu hỏi thường gặp