Cara mendapatkan kunci API Claude — jalur resmi dan jalur gateway

Ada dua cara untuk mendapatkan kunci API Claude. Jalur resmi adalah menerbitkannya langsung dari konsol Anthropic, sedangkan jalur lainnya adalah mendapatkannya dari gateway yang menyediakan endpoint kompatibel Anthropic. Keduanya memanggil model Claude yang sama; dalam kode, yang berbeda hanyalah base URL dan string kunci.

Di bawah ini kami merangkum kedua jalur tersebut, sekaligus membahas masalah pembayaran yang sering terjadi di Korea.

Jalur 1 — Menerbitkan langsung dari konsol Anthropic

Buat akun Anthropic, daftarkan metode pembayaran, lalu buat kunci API di konsol. Kunci dari jalur ini ditagihkan dengan harga resmi Anthropic, dan keuntungannya adalah Anda mendapat dokumentasi serta dukungan resmi.

Di Korea, hambatan biasanya terjadi pada tahap pembayaran. Kartu yang memblokir pembayaran internasional tidak dapat didaftarkan; mengaktifkan pembayaran internasional di aplikasi penerbit kartu lalu mencoba lagi biasanya menyelesaikan masalah.

Jalur 2 — Kunci gateway

Ini adalah cara memanggil model Claude tanpa akun Anthropic. Kunavo menyediakan Anthropic Messages API dan API yang kompatibel dengan OpenAI, sehingga Anda hanya perlu mengubah base URL dan kunci pada kode yang sudah ada.

Jalur ini juga lebih jarang terhambat pada tahap pembayaran. Pengisian prabayar Kunavo menyediakan KakaoPay, Naver Pay, PAYCO, Samsung Pay, dan kartu domestik yang tidak mengaktifkan pembayaran internasional sebagai metode pembayaran ketika checkout ditampilkan dalam won (Toss Pay tidak tersedia). Saldo yang diisi digunakan untuk panggilan Claude API, bukan untuk membayar biaya langganan 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)

Jika kode Anda menggunakan format native Anthropic, tetapkan base URL ke https://api.kunavo.com — dalam hal ini, jangan menambahkan /v1. Perbedaan antara kedua format tersebut dijelaskan dalam dokumentasi ANTHROPIC_BASE_URL.

Tarif

Tarif dibaca dari katalog saat halaman dirender, sehingga dokumen ini tidak dapat berbeda dari jumlah yang sebenarnya ditagihkan. Informasi tentang metode pembayaran dan kartu domestik dijelaskan lebih lanjut di Harga dan pembayaran Claude API.

Pemeriksaan 30 detik setelah penerbitan

Setelah mendapatkan kunci, segera lakukan satu panggilan. Pemeriksaan ini membantu Anda langsung membedakan apakah kesalahan berikutnya disebabkan oleh kunci.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 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":"안녕하세요"}]}'

Jika statusnya 200, kunci berfungsi normal. Jika 401, biasanya jenis header autentikasi tidak sesuai; 429 berarti pembatasan laju; dan 529 berarti beban berlebih pada upstream, bukan masalah kunci. Penanganan setiap kesalahan dijelaskan di ringkasan kesalahan Claude Code.

Memisahkan penggunaan kunci

Lebih aman memisahkan kunci berdasarkan tujuan penggunaan. Pencabutan satu kunci tidak memengaruhi kunci lainnya, dan Anda juga dapat menetapkan batas penggunaan bulanan untuk setiap kunci. Batas diperiksa sebelum permintaan dijalankan dan direset pada awal setiap bulan, sehingga sangat berguna saat memberikan kunci kepada agen yang berjalan tanpa pengawasan manusia.

Pertanyaan umum