---
title: Ikhtisar API
url: https://platform.claude.com/docs/id/api/overview
description: Pahami endpoint yang tersedia pada Claude API, header autentikasi, SDK klien, paginasi, batas laju, dan opsi akses platform cloud.
---
Claude API adalah RESTful API di `https://api.anthropic.com` yang menyediakan akses terprogram ke model Claude dan Claude Managed Agents.
**Baru mengenal Claude?** Untuk akses model langsung, mulailah dengan [Memulai](https://platform.claude.com/docs/id/get-started) dan [Bekerja dengan Messages](https://platform.claude.com/docs/id/build-with-claude/working-with-messages). Untuk infrastruktur agen terkelola, lihat [panduan cepat Claude Managed Agents](https://platform.claude.com/docs/id/managed-agents/quickstart).
## Prasyarat
Untuk menggunakan Claude API, Anda memerlukan:
* Sebuah [akun Claude Console](https://platform.claude.com/)
* Sebuah [kunci API](https://platform.claude.com/settings/keys) dari Console, atau aturan [Workload Identity Federation](https://platform.claude.com/docs/id/manage-claude/workload-identity-federation) yang telah dikonfigurasi
Untuk instruksi penyiapan langkah demi langkah, lihat [Memulai](https://platform.claude.com/docs/id/get-started).
## API yang tersedia
Claude API mencakup API berikut:
* **[Messages API](https://platform.claude.com/docs/id/api/messages/create):** Kirim pesan ke Claude untuk interaksi percakapan (`POST /v1/messages`)
* **[Message Batches API](https://platform.claude.com/docs/id/api/messages/batches/create):** Proses permintaan Messages dalam volume besar secara asinkron dengan pengurangan biaya 50 persen (`POST /v1/messages/batches`)
* **[Token Counting API](https://platform.claude.com/docs/id/api/messages/count_tokens):** Hitung token dalam pesan sebelum mengirimnya untuk mengelola biaya dan batas laju (`POST /v1/messages/count_tokens`)
* **[Models API](https://platform.claude.com/docs/id/api/models/list):** Tampilkan daftar model Claude yang tersedia beserta detailnya (`GET /v1/models`)
* **[Files API](https://platform.claude.com/docs/id/api/files/upload):** Unggah dan kelola file untuk digunakan di beberapa panggilan API (`POST /v1/files`, `GET /v1/files`)
* **[Skills API](https://platform.claude.com/docs/id/api/skills/create):** Buat dan kelola skill agen kustom (`POST /v1/skills`, `GET /v1/skills`)
API berikut berada dalam tahap beta:
* **[Agents API](https://platform.claude.com/docs/id/managed-agents/agent-setup):** Tentukan konfigurasi agen yang dapat digunakan kembali dan berversi untuk Claude Managed Agents (`POST /v1/agents`, `GET /v1/agents`)
* **[Sessions API](https://platform.claude.com/docs/id/managed-agents/sessions):** Jalankan sesi agen stateful di sandbox cloud terkelola (`POST /v1/sessions`, `GET /v1/sessions/{id}/events/stream`)
* **[Environments API](https://platform.claude.com/docs/id/managed-agents/environments):** 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 dalam navigasi. Untuk mengakses fitur beta, lihat [Header beta](https://platform.claude.com/docs/id/api/beta-headers).
## Autentikasi
Untuk detail tentang setiap metode autentikasi dan kapan menggunakannya, lihat [Autentikasi](https://platform.claude.com/docs/id/manage-claude/authentication). Permintaan ke Claude API menyertakan header berikut:
| Header | Nilai | Wajib |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Authorization` | `Bearer `, di mana `` adalah kunci API Anda atau token akses berumur pendek yang diperoleh dari `POST /v1/oauth/token` melalui [Workload Identity Federation](https://platform.claude.com/docs/id/manage-claude/workload-identity-federation) | Ya, kecuali `x-api-key` diatur |
| `x-api-key` | Kunci API Anda dari Console. Fallback lama untuk `Authorization`, masih didukung | Tidak |
| `anthropic-workspace-id` | ID [workspace](https://platform.claude.com/docs/id/manage-claude/workspaces) tempat permintaan dijalankan (misalnya, `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`). Lihat [Memilih workspace](https://platform.claude.com/docs/id/manage-claude/authentication#select-a-workspace). | Wajib dengan kunci API yang tidak dibatasi pada workspace. Opsional untuk kunci API lainnya. Kunci yang dibuat untuk satu workspace berjalan di workspace tersebut ketika Anda menghilangkan header ini. Tidak digunakan dengan token Workload Identity Federation, yang memilih workspace saat pertukaran token. |
| `anthropic-version` | Versi API (misalnya, `2026-10-21`) | Ya |
| `content-type` | `application/json` | Ya |
Jika Anda menggunakan [SDK Klien](https://platform.claude.com/docs/id/api/overview#client-sdks), SDK mengirim header autentikasi, versi, dan content-type secara otomatis; Anda meneruskan `anthropic-workspace-id` sendiri ketika kunci Anda memerlukannya. Untuk detail versi API, lihat [Versi API](https://platform.claude.com/docs/id/api/versioning).
Saat mengakses Claude melalui [platform cloud](https://platform.claude.com/docs/id/api/overview#claude-api-vs-cloud-platforms), 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](https://platform.claude.com/) web. Di Console, Anda dapat menggunakan [Playground](https://platform.claude.com/playground) (`platform.claude.com/playground`) untuk mencoba API di browser lalu membuat kunci API di halaman [Kunci API](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`). Untuk mempelajari caranya, lihat [Dapatkan kunci API Claude Anda](https://platform.claude.com/docs/id/get-api-key). Anda memilih jenis setiap kunci (lihat [Jenis kunci](https://platform.claude.com/docs/id/manage-claude/authentication#key-types)) dan [kedaluwarsanya](https://platform.claude.com/docs/id/manage-claude/authentication#key-expiration) saat Anda membuatnya. Gunakan [workspace](https://platform.claude.com/settings/workspaces) di Console untuk memisahkan lingkungan dan [mengontrol pengeluaran](https://platform.claude.com/docs/id/api/rate-limits) berdasarkan kasus penggunaan.
## SDK Klien
Anthropic menyediakan SDK resmi yang menyederhanakan integrasi API dengan menangani autentikasi, pemformatan permintaan, penanganan kesalahan, dan lainnya.
**Manfaat:**
* Manajemen header otomatis (autentikasi, `anthropic-version`, `content-type`)
* Penanganan permintaan dan respons yang aman tipe
* Logika percobaan ulang dan penanganan kesalahan bawaan
* Dukungan streaming
* Timeout permintaan dan manajemen koneksi
Untuk daftar SDK klien, lihat [SDK, CLI, dan library](https://platform.claude.com/docs/id/cli-sdks-libraries/overview).
## Claude API dibandingkan platform cloud
Claude tersedia melalui Claude API pihak pertama 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**
* **Terbaik 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 on AWS](https://platform.claude.com/docs/id/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/id/build-with-claude/claude-models-on-google-cloud/anthropic-managed), dan [Microsoft Foundry](https://platform.claude.com/docs/id/build-with-claude/claude-in-microsoft-foundry); platform yang dioperasikan mitra mencakup Claude Models on Google Cloud (Google managed) dan Amazon Bedrock. Lihat halaman setiap platform untuk ketersediaan dan waktu fitur.
* **Terbaik untuk:** Komitmen cloud yang sudah ada, persyaratan kepatuhan tertentu, penagihan cloud terkonsolidasi
| Platform | Penyedia | Dokumentasi |
| ------------------------------------------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Models on Google Cloud (Google managed) | Google Cloud | [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/id/build-with-claude/claude-models-on-google-cloud/google-managed) |
| Amazon Bedrock | AWS | [Claude di Amazon Bedrock (`bedrock-mantle`)](https://platform.claude.com/docs/id/build-with-claude/claude-in-amazon-bedrock) dan [Claude di Amazon Bedrock (`bedrock-runtime`)](https://platform.claude.com/docs/id/build-with-claude/claude-on-amazon-bedrock-legacy) |
| Claude Platform on AWS | AWS (dioperasikan Anthropic) | [Claude Platform on AWS](https://platform.claude.com/docs/id/build-with-claude/claude-platform-on-aws) |
| Claude Models on Google Cloud (Anthropic managed) | Google Cloud (dioperasikan Anthropic) | [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/id/build-with-claude/claude-models-on-google-cloud/anthropic-managed) |
| Microsoft Foundry | Microsoft Azure (dioperasikan Anthropic) | [Claude di Microsoft Foundry](https://platform.claude.com/docs/id/build-with-claude/claude-in-microsoft-foundry) |
Claude Managed Agents tersedia melalui Claude API pihak pertama, [Claude Platform on AWS](https://platform.claude.com/docs/id/build-with-claude/claude-platform-on-aws), dan [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/id/build-with-claude/claude-models-on-google-cloud/anthropic-managed). Untuk ketersediaan fitur di seluruh platform, lihat [Ikhtisar fitur](https://platform.claude.com/docs/id/build-with-claude/overview).
## Format permintaan dan respons
### Batas ukuran permintaan
Claude API pihak pertama menerapkan batas ukuran permintaan berikut:
| Endpoint | Ukuran permintaan maksimum |
| ---------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| Pesan, Penghitungan token | 128 MB |
| Message Batches API (lihat [Pemrosesan batch](https://platform.claude.com/docs/id/build-with-claude/batch-processing)) | 256 MB |
| [Files API](https://platform.claude.com/docs/id/build-with-claude/files) | 500 MB |
| Sesi, Agen, Lingkungan | 32 MB |
Jika Anda melampaui batas ini, Anda akan menerima kesalahan 413 `request_too_large`.
Platform yang dioperasikan mitra memiliki batas ukuran permintaan sendiri: Bedrock membatasi permintaan hingga 20 MB, dan Claude Models on Google Cloud (Google managed) membatasi permintaan hingga 30 MB. Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), dan Microsoft Foundry mendukung permintaan Messages dan Token Counting hingga 32 MB. Periksa dokumentasi platform Anda untuk nilai terkini.
### Header respons
Claude API menyertakan header berikut dalam responsnya:
| Header | Deskripsi |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `request-id` | Pengidentifikasi unik global untuk permintaan, seperti `req_018EeWyXxfu5pfWkrYcMdjWG`. Sertakan saat Anda menghubungi dukungan tentang permintaan tertentu. Lihat [ID permintaan](https://platform.claude.com/docs/id/api/errors#request-id). |
| `anthropic-organization-id` | ID organisasi tempat kunci API atau token akses yang digunakan dalam permintaan tersebut berada. |
| `anthropic-workspace-id` | ID berawalan `wrkspc_` dari [workspace](https://platform.claude.com/docs/id/manage-claude/workspaces) yang diselesaikan oleh kunci API atau token akses, seperti `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`, termasuk ketika itu adalah workspace default organisasi Anda. Tidak ada ketika kredensial tidak diselesaikan ke workspace (misalnya, pada permintaan Admin API) atau permintaan gagal sebelum autentikasi selesai. Lihat [Identifikasi workspace di balik respons API](https://platform.claude.com/docs/id/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). |
Untuk header batas laju, lihat [Header respons](https://platform.claude.com/docs/id/api/rate-limits#response-headers) di Batas laju. Untuk contoh yang membaca header respons berdasarkan nama dengan setiap SDK, lihat [Identifikasi workspace di balik respons API](https://platform.claude.com/docs/id/manage-claude/workspaces#identify-the-workspace-behind-an-api-response).
Claude Platform on AWS menambahkan ID permintaan AWS (`x-amzn-requestid`) di samping header `request-id` standar. Lihat [ID permintaan](https://platform.claude.com/docs/id/build-with-claude/claude-platform-on-aws#request-ids) untuk pola penanganan ID ganda.
## Paginasi
Endpoint daftar mengembalikan hasil dalam halaman. Sebagian besar endpoint daftar 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` di samping bidang kursor untuk menavigasi antar halaman.
| Nama | Lokasi | Deskripsi |
| ----------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit` | Parameter kueri | Jumlah maksimum item yang dikembalikan per halaman. |
| `page` | Parameter kueri | Kursor buram dari respons sebelumnya. Teruskan nilai `next_page` atau `prev_page` di sini untuk mengambil halaman yang berdekatan. |
| `order` | Parameter kueri | Arah pengurutan untuk hasil (`asc` atau `desc`), pada endpoint daftar yang mendukung pengurutan. Kursor `page` hanya valid dengan `order` yang digunakan saat dibuat. |
| `next_page` | Bidang respons | Kursor untuk halaman berikutnya, atau `null` jika tidak ada hasil lagi. |
| `prev_page` | Bidang respons | Kursor untuk halaman sebelumnya pada endpoint yang mendukung paginasi mundur (saat ini `GET /v1/sessions`), atau `null` jika Anda berada di halaman pertama. Endpoint daftar lainnya menghilangkan bidang ini. |
Untuk kembali satu halaman, teruskan `prev_page` sebagai parameter `page`. `prev_page` adalah `null` ketika Anda berada di halaman pertama. Tidak semua endpoint daftar mendukung `prev_page`. Hanya `GET /v1/sessions` yang mengembalikan `prev_page`; pada endpoint daftar yang tidak mendukung paginasi mundur, bidang tersebut tidak ada dalam respons alih-alih `null`. Untuk panduan permintaan, lihat [Mendaftar sesi](https://platform.claude.com/docs/id/managed-agents/session-operations#listing-sessions).
SDK menyediakan iterator paginasi otomatis yang mengikuti `next_page` untuk Anda. Misalnya, `for session in client.beta.sessions.list()` (typescript: `for await (const session of client.beta.sessions.list())`; go: `client.Beta.Sessions.ListAutoPaging()`; java: `client.beta().sessions().list().autoPager()`; csharp: `(await client.Beta.Sessions.List()).Paginate()`; php: `$client->beta->sessions->list()->pagingEachItem()`; ruby: `client.beta.sessions.list.auto_paging_each`) menelusuri setiap sesi. Paginasi otomatis SDK hanya bergerak maju; untuk kembali ke halaman sebelumnya, baca `prev_page` dari respons dan teruskan sendiri sebagai parameter `page`. Lihat [SDK, CLI, dan library](https://platform.claude.com/docs/id/cli-sdks-libraries/overview) untuk detailnya.
Beberapa endpoint daftar menggunakan skema kursor yang berbeda. Message Batches API (lihat [Pemrosesan batch](https://platform.claude.com/docs/id/build-with-claude/batch-processing)), [Models API](https://platform.claude.com/docs/id/api/models/list), dan beberapa endpoint [Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api) menerima parameter kueri `after_id` dan `before_id` alih-alih `page`. Responsnya mengembalikan `has_more`, `first_id`, dan `last_id` alih-alih `next_page`. Lihat halaman referensi setiap endpoint untuk field paginasi yang tepat.
## 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 tingkatan secara otomatis dan dapat berpindah 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 laju Anda di [Batas laju di Claude Console](https://platform.claude.com/usage/limits). Batas pengeluaran Anda ada di [Batas pengeluaran di Claude Console](https://platform.claude.com/settings/spend-limits) (`platform.claude.com/settings/spend-limits`). Untuk batas laju yang lebih tinggi atau batas pengeluaran bulanan yang lebih tinggi, gunakan **Minta kenaikan tingkat** di halaman **Batas laju**.
Untuk informasi terperinci tentang batas, tingkatan, dan algoritma token bucket yang digunakan untuk pembatasan laju, lihat [Batas laju](https://platform.claude.com/docs/id/api/rate-limits).
### Ketersediaan
Claude API tersedia di [banyak negara dan wilayah](https://platform.claude.com/docs/id/api/supported-regions) di seluruh dunia. Periksa halaman wilayah yang didukung untuk mengonfirmasi ketersediaan di lokasi Anda.
## Langkah selanjutnya
Spesifikasi API lengkap untuk interaksi model langsung
Endpoint Agen, Sesi, dan Lingkungan
Python, TypeScript, C#, Go, Java, PHP, dan Ruby
Tingkatan penggunaan, meminta batas yang lebih tinggi, dan algoritma token bucket