Claude API adalah antarmuka RESTful yang disediakan Anthropic di https://api.anthropic.com untuk mengakses model-model Claude secara programatik — bukan lewat chat window, melainkan kode. Dengan API ini, kamu bisa menyematkan kemampuan Claude ke aplikasi, produk, agen, atau otomatisasi kerja kamu sendiri.
Di 2026, Claude API menjadi salah satu fondasi paling populer untuk membangun aplikasi AI — dari asisten coding, agen pendukung pelanggan, hingga pipeline otomatisasi data. Panduan ini disusun untuk developer pemula: mulai dari konsep dasar, cara mendapatkan API key, autentikasi, daftar model dan harga, endpoint utama, SDK, rate limit, sampai contoh kode yang langsung bisa dijalankan.
Apa Itu Claude API?
Claude API berjalan sebagai RESTful API yang menerima permintaan (request) dan membalas dengan respons (response) berformat JSON. Untuk memakainya, kamu butuh dua hal utama:
- Akun Claude Console (platform.anthropic.com).
- API key, atau konfigurasi Workload Identity Federation.
Setiap request harus menyertakan header autentikasi serta header versi API. Saat kamu memakai Client SDK resmi, semua header ini dikirim otomatis.
Cara Mendapatkan API Key di Claude Console
Mendapatkan API key cukup mudah lewat Console:
- Masuk ke platform.anthropic.com dan buka Console.
- Gunakan Playground untuk mencoba API langsung di browser sebelum menulis kode.
- Generate API key di menu Account Settings. Kamu bisa menentukan masa berlaku (expiration) key saat membuatnya.
- Manfaatkan Workspaces untuk memisahkan API key per use case dan mengontrol pengeluaran.
Jangan lupa menyimpan key di tempat yang aman — perlakuan API key seperti password. Jika mencurigai key bocor, segera rotasi/regenerate key di Console.
Header Autentikasi dan Versi API
Semua request ke Claude API wajib menyertakan header berikut:
| Header | Nilai | Keterangan |
|---|---|---|
x-api-key | API key dari Console | Salah satu dari x-api-key atau Authorization |
Authorization | Bearer <token> | Token short-lived dari Workload Identity Federation |
anthropic-version | 2023-06-01 | Versi API |
content-type | application/json | Tipe konten |
Bila memakai Client SDK resmi, semua header ini dikirim secara otomatis — kamu tinggal fokus pada logika aplikasi.
Daftar Model dan Harga Claude API
Harga dihitung per ribuan token (per MTok = per 1 juta token), terpisah untuk input dan output. Berikut harga dari Claude Platform:
| Model | Peran | Input / MTok | Output / MTok |
|---|---|---|---|
| Claude Fable 5 | Next-gen untuk agen long-running | $10 | $50 |
| Claude Opus 5 | Agentic coding & enterprise | $5 | $25 |
| Claude Sonnet 5 | High-performance coding & agents | $2 | $10 |
| Claude Haiku 4.5 | Tercepat & paling hemat | $1 | $5 |
Beberapa catatan penting:
- Prompt caching dikenai biaya terpisah (write dan read per token) dan biasanya efektif untuk konteks besar.
- Batch processing menghemat 50% biaya untuk volume permintaan besar yang tidak perlu real-time.
- US-only inference tersedia dengan harga 1.1x untuk workload tertentu.
- Fast mode untuk Opus 5 menawarkan kecepatan hingga 2.5x dengan harga 2x.
Perlu diingat bahwa harga dapat berubah dan dipengaruhi fitur seperti caching; selalu cek halaman pricing resmi untuk nilai terbaru.
Endpoint Utama Claude API
Claude API mencakup beberapa endpoint inti:
- Messages API (
POST /v1/messages) — kirim pesan untuk interaksi konversasional. - Message Batches API (
POST /v1/messages/batches) — proses volume besar secara asinkron dengan diskon 50%. - Token Counting API (
POST /v1/messages/count_tokens) — hitung token sebelum mengirim untuk mengelola biaya. - Models API (
GET /v1/models) — daftar model dan detailnya. - Files API — unggah dan kelola file untuk dipakai lintas panggilan.
- Skills API — kelola custom skills untuk agen.
Ada juga API dalam beta: Agents API, Sessions API (sesi agen stateful), dan Environments API untuk konfigurasi sandbox.
Client SDK yang Didukung
Anthropic menyediakan SDK resmi dalam berbagai bahasa: Python, TypeScript, Go, Java, Python (lagi), C#, PHP, dan Ruby. SDK mempermudah integrasi dengan menangani:
- Manajemen header otomatis (
x-api-key,anthropic-version,content-type). - Penanganan request/response yang type-safe.
- Retry logic dan error handling bawaan.
- Dukungan streaming.
- Timeout dan manajemen koneksi.
Contoh Kode Python
Berikut contoh paling sederhana memanggil Claude API dengan SDK Python anthropic:
import anthropic
client = anthropic.Anthropic(
api_key="sk-ant-...", # ganti dengan key kamu
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[
{"role": "user", "content": "Ringkas artikel ini dalam Bahasa Indonesia."}
],
)
print(message.content[0].text)
Untuk streaming (jawaban muncul sedikit demi sedikit), gunakan mode streaming:
with client.messages.stream(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Tulis puisi pendek."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
Claude API vs Cloud Platform
Selain API langsung, Claude juga tersedia lewat cloud provider:
| Jalur | Provider | Cocok untuk |
|---|---|---|
| Claude API langsung | Anthropic | Integrasi baru, akses fitur penuh |
| Amazon Bedrock | AWS (partner-operated) | Komitmen cloud AWS, compliance |
| Claude Platform on AWS | AWS (Anthropic-operated) | Setara API langsung |
| Google Cloud | GCP (partner-operated) | Pengguna Google Cloud |
| Microsoft Foundry | Azure (Anthropic-operated) | Pengguna ekosistem Microsoft |
Pilihannya tergantung infrastruktur, kebutuhan compliance, dan preferensi billing.
Rate Limit dan Usage Tier
Claude API menerapkan rate limit dan spend limit untuk mencegah penyalahgunaan dan mengelola kapasitas. Organisasi kamu otomatis ditempatkan di usage tier tertentu, yang mendefinisikan:
- Spend limit — batas biaya bulanan.
- Rate limit — batas requests per menit (RPM) dan tokens per menit (TPM).
Kamu bisa melihat limit di halaman Rate limits dan spend limit di halaman Billing Console. Untuk kebutuhan lebih besar, ajukan Request rate limit increase.
Common Errors yang Perlu Kamu Kenali
- 429 (rate limit) — kamu melebihi batas RPM/TPM; naikkan tier atau tunggu.
- 413 (request_too_large) — ukuran request melebihi batas endpoint (Messages 32 MB, Files 500 MB).
- 401 — API key tidak valid atau kedaluwarsa.
- Output blocked / content filtering — permintaan memicu kebijakan penggunaan.
Selalu sertakan request-id dari header respons saat menghubungi dukungan untuk diagnosa request tertentu.
Claude Managed Agents
Salah satu terobosan besar di Claude Platform adalah Claude Managed Agents — seperangkat API yang bisa dikomposisikan untuk membangun dan menerapkan agen AI dalam skala produksi. Daripada mengatur infrastruktur agen sendiri, kamu cukup mendefinisikan tools, environment, dan kriteria keberhasilan, lalu Claude mengelola runtime-nya di sandbox cloud. Ini sangat membantu developer yang ingin membangun agen otonom tanpa harus urus orkestrasi dari nol.
Dengan Managed Agents, kamu bisa memanfaatkan endpoint Agents (mendefinisikan konfigurasi agen yang reusable dan berversi), Sessions (menjalankan sesi agen stateful), dan Environments (menyiapkan template sandbox). Ini membuka jalan untuk agen yang bekerja dalam jangka panjang — menganalisis data, menulis kode, atau menangani alur kerja multi-langkah — sambil tetap terkontrol.
Contoh Use Case Claude API
Claude API dipakai lintas industri untuk berbagai kebutuhan:
- Coding & engineering — menyelesaikan tugas engineering kompleks yang biasanya memakan waktu seharian.
- Customer support — triase tiket, menjawab pertanyaan kompleks dengan konteks kaya, dan alur support multi-langkah.
- Agents — menjalankan agen untuk pelanggan dengan instruction-following dan tool selection yang baik.
- Produktivitas — mengekstrak info dari email/dokumen, mengategorikan dan meringkas survei, serta mengolah teks bervolume besar.
- Prompt engineering — Console membantu membuat/memperbaiki prompt serta mengevaluasi respons terhadap skenario nyata.
Tips untuk Developer Pemula
- Mulai dari Playground untuk memahami perilaku model sebelum menulis kode.
- Pakai prompt caching untuk konteks besar yang berulang demi menghemat biaya.
- Gunakan structured outputs agar respons selalu mematuhi JSON schema kamu.
- Terapkan cost control memakai Workspaces dan spend limit per kasus penggunaan.
- Manfaatkan fitur bawaan seperti web search, memory, code execution, dan citations untuk memperkaya aplikasi tanpa membangun semuanya sendiri.
FAQ
Berapa biaya Claude API? Dihitung per token (input/output), mulai dari $1/MTok untuk Haiku 4.5 sampai $50/MTok output untuk Fable 5. Batch processing menghemat 50%.
Apakah berlangganan Claude Pro mengizinkan akses API? Tidak. Penggunaan API dan Console dihitung terpisah dari langganan Pro/Max/Team/Enterprise.
Endpoint mana untuk mengirim pesan?
POST /v1/messages via https://api.anthropic.com.
Bagaimana cara menaikkan rate limit? Ajukan Request rate limit increase di halaman Rate limits Console; tier kamu naik otomatis seiring pemakaian.
Apakah Claude API tersedia di Indonesia? Ketersediaan regional terus berkembang; cek halaman supported regions resmi Anthropic untuk daftar terbaru.
Kesimpulan
Claude API memberi developer kendali penuh untuk menyematkan kemampuan model terbaik Anthropic ke dalam produk mereka — dari chat sederhana hingga agen yang kompleks. Kuncinya adalah memahami dasar autentikasi, memilih model dan mengelola biaya dengan bijak, lalu manfaatkan SDK dan fitur bawaan agar pembangunan lebih cepat. Mulailah dengan membuat key di Console, coba contoh kode di atas, dan kembangkan bertahap.