Cara Mengintegrasikan Claude API ke dalam Aplikasi Anda
Untuk mengintegrasikan Claude API, buat kunci API di Claude Console milik Anthropic, simpan sebagai rahasia di sisi server (biasanya ANTHROPIC_API_KEY), dan panggil Messages API dari rute di server Anda sendiri menggunakan salah satu SDK resmi Anthropic. Setiap permintaan menyebutkan model, menetapkan max_tokens (balasan terpanjang yang Anda terima), dan mengirim percakapan sebagai messages, dengan instruksi Anda di system prompt yang terpisah. Atur batas pengeluaran, gunakan streaming untuk balasan panjang, dan tangani error batas laju (429) serta kelebihan beban (529) dengan percobaan ulang.
Panduan ini membahas pengaturan, alur permintaan yang aman, prompt untuk pembuat aplikasi AI, dan error yang perlu diantisipasi. Detail Anthropic diambil dari dokumentasinya per September 2026. Untuk cara kerja token dan harga secara umum, lihat cara menggunakan API LLM.
Apa yang bisa Anda bangun dengannya
- Asisten chat dan widget bantuan (cara membangun aplikasi chatbot AI)
- Ringkasan, penulisan ulang, dan draf balasan
- Ekstraksi bidang dari dokumen, email, dan formulir
- Menjawab pertanyaan dari konten Anda sendiri
- Agen yang memanggil fungsi aplikasi Anda melalui tool use
Untuk ide lainnya, lihat cara menambahkan fitur AI ke aplikasi Anda.
Messages API secara singkat
Menurut referensi API Anthropic, sebuah permintaan adalah POST ke https://api.anthropic.com/v1/messages dengan:
| Bagian | Keterangan |
|---|---|
Header x-api-key | Kunci API Anda |
Header anthropic-version | Versi API, misalnya 2023-06-01 |
model (wajib) | Model Claude yang digunakan |
max_tokens (wajib) | Jumlah token maksimum yang boleh ada dalam balasan; model mungkin berhenti lebih awal |
messages (wajib) | Percakapan: giliran user dan assistant yang bergantian |
system (opsional) | Instruksi yang berlaku untuk seluruh percakapan |
stream (opsional) | Atur ke true untuk menerima balasan saat sedang ditulis, lewat server-sent events |
API bersifat stateless: untuk melanjutkan percakapan, kirim ulang giliran sebelumnya di setiap permintaan. Itulah sebabnya chat yang panjang membuat biaya per pesan lebih tinggi.
Anthropic menerbitkan SDK resmi untuk Python, TypeScript, C#, Go, Java, PHP, dan Ruby. SDK tersebut mengatur header, mengurai respons, dan mendukung streaming. Gunakan salah satunya daripada HTTP mentah kecuali Anda punya alasan khusus.
Memilih model
Anthropic menawarkan beberapa model Claude yang menyeimbangkan kemampuan dengan kecepatan dan harga, dan daftar ini berubah dari waktu ke waktu. Pilih model terkecil yang sudah cukup baik untuk tugas Anda, uji dengan contoh nyata, dan simpan ID model di konfigurasi agar Anda bisa mengganti tanpa mengubah kode. Periksa halaman model dan harga Anthropic untuk opsi dan tarif terkini.
Menyiapkan akun Anda
- Masuk ke Claude Console di platform.claude.com dan tambahkan penagihan.
- Buat kunci API. Simpan satu kunci untuk setiap lingkungan (pengujian dan produksi) agar Anda bisa mencabut salah satunya tanpa merusak yang lain.
- Atur batas pengeluaran. Halaman error Anthropic mencatat bahwa ketika penggunaan mencapai batas pengeluaran yang Anda atur, API mengembalikan error 400, jadi aplikasi Anda sebaiknya menampilkan pesan yang jelas saat itu terjadi.
- Tinjau batas laju untuk akun Anda di Console; batas ini diukur per organisasi.
Alur permintaan
- Pengguna melakukan sesuatu di aplikasi Anda: mengirim pesan, mengklik "Ringkas".
- Browser memanggil rute server Anda, bukan langsung ke Anthropic.
- Server Anda memeriksa bahwa pengguna sudah masuk dan diizinkan menggunakan fitur tersebut, lalu menerapkan batas per pengguna.
- Server menyusun permintaan: system prompt dengan aturan Anda, input pengguna, dan data apa pun yang dibutuhkan tugas dari database Anda.
- Server memanggil Messages API dengan kunci dari environment dan
max_tokensyang masuk akal. - Server men-streaming balasan ke browser dan mencatat penggunaan token dari respons.
Pilihan dan trade-off
| Keputusan | Pilihan sederhana | Kapan perlu lebih jauh |
|---|---|---|
| Streaming | Menunggu balasan lengkap | Gunakan streaming untuk chat dan apa pun yang panjang; Anthropic merekomendasikan streaming atau batch untuk permintaan yang berjalan lama |
| Format output | Teks biasa | Output JSON terstruktur saat kode Anda perlu membaca bidang |
| Data Anda | Sertakan catatan yang relevan | Retrieval atas konten Anda saat datanya terlalu banyak (apa itu RAG) |
| Tindakan | Model hanya menulis teks | Tool use, di mana model meminta kode Anda menjalankan fungsi yang Anda definisikan |
| Pekerjaan massal yang tidak mendesak | Loop melalui item | Message Batches API, yang Anda kirim dan cek hasilnya secara berkala |
Prompt untuk pembuat aplikasi AI Anda
Fitur pertama:
Tambahkan panel "Tanya tentang dokumen ini". Panel ini memanggil rute server POST /api/ask yang memeriksa bahwa pengguna sudah masuk dan memiliki dokumen tersebut, lalu memanggil Claude Messages API dengan SDK Anthropic resmi dan rahasia ANTHROPIC_API_KEY. Baca ID model dari rahasia CLAUDE_MODEL. System prompt: "Jawab hanya berdasarkan dokumen yang diberikan. Jika jawabannya tidak ada di dalamnya, katakan demikian." Kirim teks dokumen dan pertanyaannya, atur max_tokens ke 800, stream jawabannya ke halaman, dan jangan pernah mengekspos kunci ke browser.
Pengaman dan error:
Batasi setiap pengguna hingga 20 pertanyaan per jam, dilacak di database. Catat token input dan output dari setiap respons beserta ID pengguna dan ID permintaan. Pada error 429 atau 529, coba lagi dengan exponential backoff hingga 3 kali, hormati header retry-after jika ada, lalu tampilkan "Asisten sedang sibuk, coba lagi sebentar lagi." Jika API melaporkan error batas pengeluaran, tampilkan "Fitur AI dijeda" dan beri tahu admin.
Error yang perlu diantisipasi
Dari dokumentasi error Anthropic, berikut yang benar-benar akan ditemui aplikasi Anda:
| Kode | Tipe | Yang harus dilakukan |
|---|---|---|
| 400 | invalid_request_error | Perbaiki permintaan; juga dikembalikan saat Anda mencapai batas pengeluaran yang Anda atur |
| 401 | authentication_error | Periksa kunci ada, benar, dan belum dicabut |
| 413 | request_too_large | Kirim lebih sedikit; Messages API menerima hingga 32 MB per permintaan |
| 429 | rate_limit_error | Mundur dan coba lagi, hormati retry-after |
| 500 | api_error | Coba lagi dengan backoff; hubungi dukungan dengan ID permintaan jika terus terjadi |
| 529 | overloaded_error | Lalu lintas tinggi sementara dari semua pengguna; mundur dan coba lagi |
Dokumentasi Anthropic menyebutkan bahwa SDK resmi secara otomatis mencoba ulang kegagalan sementara (error koneksi, batas laju, dan error 5xx) dua kali secara default dengan exponential backoff, dan Anda bisa mengonfigurasinya. Setiap respons membawa header request-id; catat agar dukungan bisa melacak masalah.
Kesalahan umum
- Memanggil API dari browser. Kunci Anda menjadi publik. Selalu lewat server Anda. Lihat cara menjaga kunci API tetap aman.
- Lupa bahwa
max_tokensadalah batas, bukan target. Atur sesuai kebutuhan fitur; terlalu rendah memotong jawaban, terlalu tinggi berisiko balasan panjang yang mahal. - Menaruh aturan di pesan pengguna. Instruksi yang stabil sebaiknya ada di system prompt; izin sebaiknya ada di kode Anda.
- Mengirim seluruh chat selamanya. Pangkas atau ringkas giliran lama seiring percakapan bertambah.
- Tidak ada batas pengeluaran atau batas per pengguna.
- Menulis ID model secara permanen di kode. Model diperbarui dan dihentikan.
- Mengabaikan stop reason. Jika balasan berhenti karena mencapai
max_tokens, beri tahu pengguna atau naikkan batasnya.
Daftar periksa
- Kunci API dibuat di Claude Console dan disimpan sebagai rahasia di sisi server
- Kunci terpisah untuk pengujian dan produksi
- Batas pengeluaran diatur; ada pesan jelas saat tercapai
- Semua permintaan lewat server Anda dengan pemeriksaan izin
- System prompt berisi aturan; ID model bisa dikonfigurasi
-
max_tokensdiatur per fitur; balasan panjang di-stream - Batas laju per pengguna di aplikasi Anda
- 429 dan 529 ditangani dengan backoff; ID permintaan dicatat
- Status error yang ramah dan tidak merusak halaman
- Diuji dengan input kosong, sangat panjang, dan bermusuhan
Menggunakan Claude API di Mythex
Di aplikasi yang Anda bangun di Mythex, fitur Claude menggunakan kunci Anthropic milik Anda sendiri dan ditagihkan ke akun Anthropic Anda, bukan ke kredit build Mythex. Ini terpisah dari agen Mythex yang menulis kode Anda. Tambahkan ANTHROPIC_API_KEY sebagai rahasia proyek melalui /secrets, pengaturan proyek, atau kartu rahasia di chat, lalu jelaskan fiturnya dengan prompt seperti di atas. Publikasikan ulang setelah mengubah rahasia pada aplikasi yang sudah live. Lihat Tambahkan fitur AI dengan kunci API Anda sendiri untuk prompt awal. Jika Anda memilih antara penyedia, cara mengintegrasikan OpenAI API membahas hal yang sama untuk OpenAI.
Pertanyaan
Bagaimana cara mendapatkan kunci API Claude?
Masuk ke Claude Console di platform.claude.com, atur penagihan, lalu buat kunci API. Simpan sebagai rahasia di sisi server, biasanya dengan nama ANTHROPIC_API_KEY, dan jangan pernah memasukkannya ke kode browser.
Apa yang dibutuhkan oleh permintaan ke Claude API?
Per September 2026, referensi Messages API dari Anthropic mencantumkan tiga kolom wajib dalam body: model, max_tokens, dan messages. Panggilan HTTP langsung juga membutuhkan header x-api-key dan anthropic-version; SDK resmi mengatur keduanya untuk Anda.
Apa itu error 529 dari Claude API?
Halaman error Anthropic menjelaskan 529 sebagai overloaded_error: API sedang kelebihan beban sementara karena lalu lintas tinggi dari semua pengguna. Coba lagi dengan exponential backoff. SDK resmi secara otomatis mencoba ulang beberapa error sementara.
Bisakah saya menggunakan Claude dengan kode yang ditulis untuk SDK OpenAI?
Anthropic mendokumentasikan lapisan kompatibilitas SDK OpenAI untuk menggunakan Claude melalui antarmuka SDK OpenAI. Untuk kode baru, SDK milik Anthropic memberi akses ke fitur khusus Claude, jadi biasanya itu titik awal yang lebih baik.