Kunci API Anthropic adalah kredensial yang Anda kirim dengan setiap permintaan ke API Claude. Kunci ini diawali dengan sk-ant-, Anda membuatnya di Konsol Claude, dan tagihan penggunaan akan mengurangi kredit prabayar organisasi Anda. Jika Anda belum pernah menggunakannya, panduan dasar kami tentang apa itu kunci API mencakup ide umumnya. Panduan ini membahas hal spesifik: membuat akun Konsol, mengisi kredit, membuat kunci dengan cakupan yang benar, mengirim permintaan Pesan pertama dengan curl dan Python SDK, serta menjaga kunci agar tidak bermasalah setelahnya.
Halaman resmi Anthropic dapatkan kunci API Anda memberitahu Anda di mana tombolnya berada. Namun, tidak memberitahu mengapa permintaan pertama mengembalikan kode 401, ID model mana yang saat ini berlaku, atau bagaimana menguji kunci tanpa menempelkannya ke riwayat shell Anda. Itulah yang dibahas oleh sisa panduan ini.
Apa yang Anda butuhkan sebelum memulai
- Email untuk Konsol Claude di platform.claude.com (console.anthropic.com sekarang mengarah ke sana).
- Kartu pembayaran. API bersifat prabayar, dan hanya peran Admin atau Penagihan yang dapat membeli kredit.
- Curl, atau Python 3.10+ untuk contoh SDK.
- Apidog untuk menyimpan kunci sebagai variabel lokal dan menyimpan permintaan sebagai pengujian yang dapat diulang. Paket gratis mencakup tim hingga empat orang.
Langkah 1: Buat akun Konsol Claude
Daftar di platform.claude.com. Ini akan membuat organisasi dengan Ruang Kerja Default, dan kunci, kredit, serta batasan kecepatan Anda semuanya terkait dengannya. Jika rekan tim sudah membuatnya, mintalah undangan daripada membuat organisasi kedua: kredit dan tingkatan penggunaan tidak dapat ditransfer.
Langkah 2: Tambahkan kredit sebelum panggilan pertama Anda
Ya, kredit didahulukan. Dokumen penagihan Anthropic langsung: beli kredit sebelum Anda menggunakan API, dan dengan saldo nol, baik API maupun playground tidak akan berfungsi. Pengguna baru mendapatkan sedikit kredit gratis untuk menguji, jadi periksa saldo Anda sebelum membeli, tetapi anggap itu sebagai bonus daripada rencana.
Buka Pengaturan > Penagihan dan klik Beli kredit. Aktifkan isi ulang otomatis jika Anda menjalankan sesuatu tanpa pengawasan. Lihat cara membeli kredit untuk langkah-langkah saat ini. Organisasi Anda juga akan ditempatkan pada tingkatan penggunaan dengan batas pengeluaran bulanan, yang dibahas di bagian batasan kecepatan.
Langkah 3: Buat kunci API
Buka Pengaturan > Kunci API dan klik Buat kunci. Ada empat pilihan penting:
- Nama: beri nama sesuai aplikasi, bukan orangnya.
orders-service-staginglebih baik daripadakunci saya. - Kedaluwarsa: 3 jam hingga 30 hari, kustom, atau Tidak Pernah. Pilih masa pakai yang pendek untuk pengujian; ini tidak dapat diubah nanti.
- Akun tertaut: diri Anda sendiri untuk kunci pribadi, akun layanan untuk yang dibagikan. Kunci pribadi akan mati saat Anda meninggalkan organisasi.
- Ruang Kerja: cakupkan ke satu ruang kerja dan Anda dapat melewati header
anthropic-workspace-id. Kunci multi-ruang kerja harus mengirimkannya pada setiap permintaan atau Anda akan mendapatkan 400.
Konsol menampilkan kunci lengkap hanya sekali, jadi salin langsung ke manajer rahasia Anda. Tidak ada tombol tampilkan. Jika Buat kunci berwarna abu-abu, peran Anda tidak dapat membuat kunci; mintalah kepada admin.
Langkah 4: Tiga header yang dibutuhkan setiap permintaan
Setiap panggilan ke POST https://api.anthropic.com/v1/messages membawa tiga header.
| Header | Nilai | Catatan |
|---|---|---|
x-api-key |
kunci sk-ant-... Anda |
Authorization: Bearer <key> juga berfungsi dan sekarang merupakan bentuk primer yang didokumentasikan; x-api-key adalah fallback lama dan masih didukung |
anthropic-version |
2023-06-01 |
Wajib. Menetapkan format respons. Tanggalnya stabil dan tidak terkait dengan rilis model |
content-type |
application/json |
Wajib untuk body JSON |
SDK resmi mengirimkan ketiganya untuk Anda. HTTP mentah dan klien API perlu menuliskannya secara eksplisit, yang merupakan penyebab sebagian besar kegagalan permintaan pertama. Referensi lengkap: Ikhtisar API Claude.
Langkah 5: Kirim permintaan Pesan pertama Anda
Body membutuhkan model, max_tokens, dan messages. Gunakan ID model saat ini: per September 2026 adalah claude-opus-5 (yang direkomendasikan default), claude-fable-5-1 (paling mampu), claude-sonnet-5, dan claude-haiku-4-5. ID 3.x dan 4.x yang lebih lama mengembalikan 404 atau menunjuk ke model yang sudah tidak digunakan, dan ID saat ini tidak memiliki akhiran tanggal. Panduan API Claude Opus 5 membahas lebih dalam tentang pemikiran, upaya, dan streaming.
curl
export ANTHROPIC_API_KEY="sk-ant-api03-..."
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Tulis deskripsi OpenAPI satu kalimat untuk POST /orders, yang membuat pesanan dan mengembalikan 201."}
]
}'
Respons yang berhasil, dipersingkat:
{
"id": "msg_01...",
"role": "assistant",
"model": "claude-opus-5",
"content": [{"type": "text", "text": "Membuat pesanan baru dan mengembalikannya dengan status 201."}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 31, "output_tokens": 24}
}
Baca teks dari content[].text, periksa apakah stop_reason adalah end_turn, dan pertahankan usage untuk pelacakan biaya. Header respons request-id adalah apa yang diminta oleh dukungan ketika terjadi kegagalan.
Python SDK
pip install anthropic
import anthropic
client = anthropic.Anthropic() # membaca ANTHROPIC_API_KEY dari environment
message = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
messages=[{
"role": "user",
"content": "Tulis deskripsi OpenAPI satu kalimat untuk POST /orders, yang membuat pesanan dan mengembalikan 201.",
}],
)
for block in message.content:
if block.type == "text":
print(block.text)
SDK membaca ANTHROPIC_API_KEY, menambahkan header versi dan content-type, serta mencoba kembali 429 dan 5xx dua kali dengan backoff. Jangan pernah meneruskan kunci sebagai string literal; variabel lingkungan adalah intinya.
Langkah 6: Simpan dan uji kunci di Apidog
Kunci yang ditempelkan ke shell akan tersimpan di file riwayat Anda. Kunci yang disimpan dalam permintaan bersama akan disinkronkan ke rekan tim. Apidog memisahkan keduanya: struktur permintaan dibagikan, rahasia tetap ada di mesin Anda.
Simpan kunci sebagai variabel lokal. Buka Manajemen Lingkungan, buat lingkungan bernama Anthropic, dan tambahkan variabel ANTHROPIC_API_KEY. Biarkan nilai yang dibagikan sebagai SET_LOCALLY dan tempelkan kunci sebenarnya ke nilai lokal, yang tetap berada di cache klien Anda dan tidak pernah disinkronkan. Panduan kami untuk lingkungan Apidog dan variabel rahasia membahas aturan cakupan.
Atur header sekali. Di panel yang sama, tambahkan dua parameter global di bawah Header: x-api-key diatur ke {{ANTHROPIC_API_KEY}}, dan anthropic-version diatur ke 2023-06-01. Parameter ini berlaku untuk setiap permintaan dalam proyek, dan Apidog menambahkan content-type secara otomatis untuk body JSON.
Kirim permintaan pertama. Permintaan baru, POST ke https://api.anthropic.com/v1/messages, tempelkan body JSON dari contoh curl, kirim. Buka tab Permintaan Aktual untuk mengonfirmasi kedua header dikirim dengan variabel yang sudah dipecahkan. Tab itu adalah cara tercepat untuk membuktikan bahwa 401 adalah masalah header, bukan masalah kunci.
Simpan sebagai uji. Simpan permintaan sebagai kasus titik akhir, lalu tambahkan tiga pernyataan: status sama dengan 200, stop_reason sama dengan end_turn, dan usage.output_tokens di atas 0. Jalankan dari Apidog CLI dan masukkan kunci dari penyimpanan rahasia CI Anda saat runtime. Itu adalah uji asap satu klik untuk kunci, header, dan ID model. Unduh Apidog untuk mengikuti; paket gratis mencakup empat kursi.
Batas kecepatan dan biaya permintaan
Batas berlaku per organisasi dan per model: permintaan per menit (RPM), token input per menit (ITPM), dan token output per menit (OTPM). Hanya input yang tidak di-cache yang dihitung dalam ITPM, jadi caching prompt meningkatkan throughput tanpa perubahan tingkatan. Dari dokumentasi batasan kecepatan:
| Tingkat | Batas pengeluaran bulanan | Claude Opus 5 (RPM / ITPM / OTPM) | Claude Fable 5.x (RPM / ITPM / OTPM) |
|---|---|---|---|
| Mulai | $500 | 1,000 / 2 juta / 400 ribu | 1,000 / 500 ribu / 100 ribu |
| Bangun | $1,000 | 5,000 / 5 juta / 1 juta | 2,000 / 1,5 juta / 300 ribu |
| Skala | $200,000 | 10,000 / 10 juta / 2 juta | 4,000 / 4 juta / 800 ribu |
| Kustom | tidak ada | dinegosiasikan | dinegosiasikan |
Sonnet 5 dan Haiku 4.5 berbagi angka Opus 5 di setiap tingkatan. Setiap respons membawa header anthropic-ratelimit-*-remaining dan -reset, sehingga Anda dapat memantau sisa kuota tanpa perlu melakukan polling ke Konsol.
Per juta token, dari halaman harga: Opus 5 adalah $5 masuk / $25 keluar, Sonnet 5 $2 / $10, Fable 5.1 $10 / $50, Haiku 4.5 $1 / $5. Pembacaan cache berbiaya 10% dari input (2.5% pada Fable 5.1) dan API Batch mengurangi kedua sisi separuhnya. Permintaan curl pertama itu berbiaya sepersekian sen.
Kesalahan umum dan cara memperbaikinya
Kesalahan dikembalikan sebagai JSON dengan error.type dan request_id. Referensi kesalahan mencantumkan setiap kode; ini adalah yang akan Anda temui pertama kali.
| Status dan tipe | Penyebab umum | Perbaikan |
|---|---|---|
401 authentication_error |
Kunci salah format, dicabut, kedaluwarsa, atau variabel env kosong | echo $ANTHROPIC_API_KEY dan periksa spasi kosong di akhir; buat kunci baru jika sudah kedaluwarsa |
400 invalid_request_error |
max_tokens hilang, JSON salah format, kunci multi-ruang kerja tanpa anthropic-workspace-id, thinking.type: enabled pada model 4.7+, atau batas pengeluaran yang Anda tetapkan telah tercapai |
Baca error.message; itu akan menyebutkan bidang atau batasnya |
404 not_found_error |
Salah ketik ID model, tebakan dengan akhiran tanggal, model yang sudah tidak digunakan, atau jalur yang salah | Gunakan ID dari tabel model saat ini, dan konfirmasi jalur adalah /v1/messages |
402 billing_error |
Masalah pembayaran atau kredit | Periksa Pengaturan > Penagihan |
429 rate_limit_error |
Anda melebihi RPM, ITPM, atau OTPM | Tunggu beberapa detik di retry-after, lalu coba lagi. Tidak ada header retry-after berarti Anda mencapai batas pengeluaran bulanan tingkatan (error_code: enforced_spend_limit_reached) |
500 api_error / 529 overloaded_error |
Kesalahan sisi Anthropic atau lalu lintas tinggi | Coba lagi dengan backoff; simpan request_id |
Kebersihan kunci: rotasi, cakupan, dan tidak pernah dalam kode klien
Jangan pernah mengirimkan kunci ke browser atau aplikasi seluler. Apa pun dalam bundel JavaScript atau APK akan bersifat publik dalam hitungan menit. Tempatkan panggilan di balik backend Anda sendiri. Untuk aplikasi Apple yang harus memanggil Claude secara langsung, App Attest mengeluarkan token berumur pendek untuk build yang terverifikasi, bukan kunci statis.
Satu kunci per aplikasi dan lingkungan. Pisahkan kunci staging dan produksi di ruang kerja terpisah memungkinkan Anda membatasi pengeluaran staging dan mencabut satu tanpa menyentuh yang lain.
Rotasi sesuai jadwal. Buat kunci baru, terapkan, konfirmasi berfungsi, lalu hapus kunci lama. Nonaktifkan dapat dibatalkan; Hapus bersifat permanen. Curiga ada kebocoran, nonaktifkan terlebih dahulu dan selidiki kemudian. Pemindai rahasia di repositori Anda menangkap kunci yang di-commit sebelum ada yang menyadarinya.
Pilih kredensial berumur pendek dalam produksi. Workload Identity Federation menukar token identitas penyedia cloud Anda dengan token Claude berumur pendek, sehingga tidak ada string sk-ant- yang bocor sama sekali.
FAQ
Apakah kunci API Anthropic sama dengan kunci API Claude?
Ya. Konsol, SDK, dan dokumen sekarang menyebut "Claude API", dan format serta header kuncinya identik. Tutorial lama yang menyebut "kunci API Anthropic" berarti kredensial yang sama.
Bisakah saya mendapatkan kunci API Anthropic secara gratis?
Membuat kunci itu gratis. Menggunakannya mengambil dari kredit prabayar, dan halaman harga Anthropic mengatakan pengguna baru mendapatkan sedikit kredit gratis untuk diuji. Jika Anda mencoba menjalankan beban kerja nyata tanpa membayar, baca rincian jujur kami tentang akses API Claude gratis sebelum Anda membangun apa pun di sekitarnya.
Apakah langganan Claude Pro atau Max termasuk akses API?
Tidak. Langganan Claude.ai dan kredit API Konsol ditagih secara terpisah. Anda memerlukan organisasi Konsol dengan kredit, meskipun Anda sudah membayar Claude.ai.
Apa yang terjadi ketika kunci saya kedaluwarsa?
Permintaan mengembalikan 401 authentication_error. Kunci yang kedaluwarsa tidak dapat diaktifkan kembali, jadi buat yang baru dan perbarui variabel lingkungan. Anthropic mengirim email kepada pembuat kunci tujuh hari dan satu hari sebelum kedaluwarsa untuk kunci dengan masa pakai yang cukup panjang.
Langkah selanjutnya
Buat kunci dengan kedaluwarsa 7 hari, masukkan ke variabel lokal Apidog, jalankan uji asap, dan baru kemudian masukkan ke dalam kode. Jika itu berhasil, kredensial, header, dan ID model semuanya benar, dan setiap 401 setelah itu adalah masalah nyata daripada salah ketik.