Ikhtisar API

Claude API adalah RESTful API di https://api.anthropic.com yang menyediakan akses terprogram ke model Claude dan Claude Managed Agents.



Prasyarat

Untuk menggunakan Claude API, Anda memerlukan:

• Akun Claude Console
• Kunci API, atau aturan Workload Identity Federation yang telah dikonfigurasi

Untuk petunjuk penyiapan langkah demi langkah, lihat Memulai.



API yang tersedia

Claude API mencakup API berikut:

Ketersediaan Umum:

• Messages API: Kirim pesan ke Claude untuk interaksi percakapan (POST /v1/messages)
• Message Batches API: Proses permintaan Messages dalam volume besar secara asinkron dengan pengurangan biaya 50% (POST /v1/messages/batches)
• Token Counting API: Hitung token dalam pesan sebelum mengirim untuk mengelola biaya dan batas laju (POST /v1/messages/count_tokens)
• Models API: Daftar model Claude yang tersedia beserta detailnya (GET /v1/models)

Beta:

• Files API: Unggah dan kelola file untuk digunakan di berbagai panggilan API (POST /v1/files, GET /v1/files)
• Skills API: Buat dan kelola keterampilan agen kustom (POST /v1/skills, GET /v1/skills)
• Agents API: Definisikan konfigurasi agen yang dapat digunakan kembali dan berversi untuk Claude Managed Agents (POST /v1/agents, GET /v1/agents)
• Sessions API: Jalankan sesi agen stateful di sandbox cloud terkelola (POST /v1/sessions, GET /v1/sessions/{id}/stream)
• Environments API: Konfigurasikan template sandbox untuk sesi agen (POST /v1/environments, GET /v1/environments)

Untuk referensi API lengkap dengan semua endpoint, parameter, dan skema respons, jelajahi halaman referensi API yang tercantum di navigasi. Untuk mengakses fitur beta, lihat Header beta.



Autentikasi

Untuk detail tentang kedua metode autentikasi dan kapan menggunakan masing-masing, lihat Autentikasi. Semua permintaan ke Claude API harus menyertakan header berikut:

Jika Anda menggunakan Client SDK, SDK akan mengirim header ini secara otomatis. Untuk detail versi API, lihat Versi API.

Saat mengakses Claude melalui platform cloud, autentikasi terintegrasi dengan sistem IAM penyedia cloud. Lihat dokumentasi khusus platform untuk jenis kredensial yang didukung, header yang diperlukan, dan opsi autentikasi.



Mendapatkan kunci API

API tersedia melalui Console berbasis web. Anda dapat menggunakan Workbench untuk mencoba API di browser dan kemudian membuat kunci API di Pengaturan Akun. Gunakan workspace untuk mengelompokkan kunci API Anda dan mengontrol pengeluaran berdasarkan kasus penggunaan.



Client SDK

Anthropic menyediakan SDK resmi yang menyederhanakan integrasi API dengan menangani autentikasi, pemformatan permintaan, penanganan kesalahan, dan lainnya.

Manfaat:

• Manajemen header otomatis (x-api-key, anthropic-version, content-type)
• Penanganan permintaan dan respons yang type-safe
• Logika retry dan penanganan kesalahan bawaan
• Dukungan streaming
• Timeout permintaan dan manajemen koneksi

Untuk daftar client SDK, lihat Client SDK.



Claude API vs platform cloud

Claude tersedia melalui Claude API langsung dan melalui platform cloud. Pilih berdasarkan infrastruktur, ketersediaan fitur, persyaratan kepatuhan, dan preferensi harga Anda.



Claude API

• Akses langsung ke model dan fitur terbaru
• Penagihan dan dukungan Anthropic
• Paling cocok untuk: Integrasi baru, akses fitur penuh, hubungan langsung dengan Anthropic



API platform cloud

Akses Claude melalui AWS, Google Cloud, atau Microsoft Azure:

• Terintegrasi dengan penagihan dan IAM penyedia cloud
• Ketersediaan fitur bervariasi menurut platform: Platform yang dioperasikan Anthropic mencakup Claude Platform di AWS dan Microsoft Foundry; platform yang dioperasikan mitra mencakup Amazon Bedrock dan Google Cloud. Lihat halaman masing-masing platform untuk ketersediaan dan waktu fitur.
• Paling cocok untuk: Komitmen cloud yang sudah ada, persyaratan kepatuhan tertentu, penagihan cloud terkonsolidasi



Format permintaan dan respons



Batas ukuran permintaan

Jika Anda melebihi batas ini, Anda akan menerima kesalahan 413 request_too_large.



Header respons

Claude API menyertakan header berikut di setiap respons:

• request-id: Pengidentifikasi unik global untuk permintaan
• anthropic-organization-id: ID organisasi yang terkait dengan kunci API yang digunakan dalam permintaan



Paginasi

Endpoint list mengembalikan hasil dalam halaman. Sebagian besar endpoint list yang lebih baru menggunakan skema kursor page dan next_page yang dijelaskan di bagian ini. Beberapa menggunakan skema yang berbeda; lihat catatan di akhir bagian ini. Gunakan parameter kueri limit untuk mengontrol ukuran halaman dan parameter kueri page untuk mengambil halaman yang berdekatan. Setiap respons menyertakan array data beserta field kursor untuk menavigasi antar halaman.

Untuk kembali satu halaman, berikan prev_page sebagai parameter page. prev_page bernilai null ketika Anda berada di halaman pertama. Tidak semua endpoint list mendukung prev_page. Hanya GET /v1/sessions yang mengembalikan prev_page; pada endpoint list yang tidak mendukung paginasi mundur, field tersebut tidak ada dalam respons, bukan bernilai null. Untuk panduan permintaan, lihat Mendaftar sesi.

Setiap SDK menyediakan iterator paginasi otomatis yang mengikuti next_page untuk Anda. Di Python dan TypeScript, Anda mendapatkannya dengan melakukan iterasi langsung pada hasil list. SDK lainnya menyediakan iterator melalui metode terpisah. Paginasi otomatis SDK hanya bergerak maju; untuk kembali satu halaman, baca prev_page dari respons dan berikan kembali sebagai parameter page secara manual. Lihat client SDK untuk detail spesifik bahasa.



Batas laju dan ketersediaan



Batas laju

API menerapkan batas laju dan batas pengeluaran untuk mencegah penyalahgunaan dan mengelola kapasitas. Batas diatur ke dalam tingkatan penggunaan; organisasi Anda ditempatkan pada suatu tingkatan secara otomatis dan dapat naik ke tingkatan yang lebih tinggi seiring waktu. Setiap tingkatan memiliki:

• Batas pengeluaran: Biaya bulanan maksimum untuk penggunaan API
• Batas laju: Jumlah maksimum permintaan per menit (RPM) dan token per menit (TPM)

Anda dapat melihat batas organisasi Anda saat ini di Console. Untuk batas yang lebih tinggi, gunakan Request rate limit increase di halaman Limits.

Untuk informasi terperinci tentang batas, tingkatan, dan algoritma token bucket yang digunakan untuk pembatasan laju, lihat Batas laju.



Ketersediaan

Claude API tersedia di banyak negara dan wilayah di seluruh dunia. Periksa halaman wilayah yang didukung untuk mengonfirmasi ketersediaan di lokasi Anda.



Langkah selanjutnya