Panduan API Claude: Harga, Pengaturan, dan Permintaan Pertama Anda

Untuk melakukan permintaan API Claude pertama Anda, buatlah kunci Claude Console, simpan kunci tersebut dalam variabel lingkungan, panggil titik akhir Messages, lalu baca hasil yang dikembalikan penggunaan kolom, dan menghitung biaya token. Panduan ini memaparkan langkah-langkah tersebut dengan menggunakan ID model dan harga terkini yang telah diverifikasi pada tanggal 8 September 2026.

Setelah Anda memahami jalur API, pertanyaan selanjutnya adalah seberapa banyak dari pekerjaan sehari-hari Anda yang sebenarnya memerlukan integrasi khusus. Untuk penelitian, penulisan, pemrograman, dan produksi kreatif, GlobalGPT menawarkan cara yang lebih hemat untuk menggunakan Claude bersama dengan GPT-5.6 Sol, Gemini 3 Pro, Kimi K3, dan model-model terkemuka lainnya. Satu langganan menyatukan model-model tersebut dan serangkaian alat AI yang luas ke dalam satu dasbor, sehingga pekerjaan dapat berjalan dari ide hingga hasil akhir tanpa harus terbagi di antara layanan yang terpisah. Saat Anda memang perlu mengintegrasikan AI ke dalam lingkungan pengembangan Anda, GlobalGPT CLI menghubungkan ruang kerja yang sama ke terminal dan alat produksi yang sudah ada.

Coba Claude Opus 5

Apa Itu API Claude?

API Claude adalah antarmuka pengembang Anthropic yang digunakan untuk mengirimkan permintaan terstruktur ke model-model Claude dari sebuah aplikasi, skrip, atau layanan backend. Anda mengirimkan pesan ke titik akhir HTTPS dan menerima respons terstruktur yang berisi konten yang dihasilkan serta metadata seperti model, alasan penghentian, dan penggunaan token.

Langganan Claude API vs. Claude.ai

Akses API dan langganan Claude.ai dirancang untuk memenuhi kebutuhan yang berbeda. Paket Claude.ai memberikan akses kepada pengguna ke produk obrolan Anthropic. API merupakan akses pengembang berbasis kuota melalui Claude Console, dengan penagihan terpisah berdasarkan penggunaan. Pusat Bantuan Anthropic menyatakan bahwa Claude Pro tidak mencakup penggunaan API Console.

Jika Anda memerlukan penjelasan lebih rinci mengenai perbedaan antara paket konsumen, Kode Claude, dan penagihan berbasis token, silakan lihat panduan lengkap kami Panduan Harga Claude. Untuk tutorial ini, intinya sederhana: buat dan isi saldo akun API secara terpisah dari langganan Claude.ai mana pun.

Lima langkah menuju permintaan pertama

1. Buat kunci API di Konsol Claude.
2. Simpan di ANTHROPIC_API_KEY variabel lingkungan.
3. Kirim permintaan ke https://api.anthropic.com/v1/messages.
4. Baca konten yang dikembalikan dan penggunaan objek.
5. Kalikan setiap kategori token dengan tarif per satu juta token yang berlaku untuknya.

Harga API Claude dan ID Model Terkini

Anthropic mencantumkan harga API dalam dolar AS per juta token, yang sering disingkat menjadi MTok. Masukan dan keluaran ditagih secara terpisah. Penyimpanan sementara (caching) prompt menerapkan tarif yang berbeda untuk penulisan setiap lima menit, penulisan setiap satu jam, dan pembacaan dari cache, sehingga perkiraan yang akurat harus memisahkan kategori-kategori tersebut.

Model terkini dan ID API yang tepat

Model mana yang sebaiknya Anda gunakan untuk tutorial ini?

Panduan Cepat resmi yang digunakan claude-opus-5 pada saat panduan ini diverifikasi, sehingga contoh cURL dan Python di bawah ini menggunakan ID yang sama. Gunakan Opus sebagai titik awal untuk tutorial ini, lalu pilih model produksi berdasarkan beban kerja, kebutuhan kualitas, latensi, dan anggaran. ID model serta status siklus hidupnya dapat berubah, jadi periksa kembali halaman Model dan Penghentian Dukungan sebelum merilis kode yang akan digunakan dalam jangka panjang.

Hal-Hal yang Perlu Anda Siapkan Sebelum Mengajukan Permohonan Pertama Anda

Buat akun Console Claude dan kunci API

Buka Konsol Claude, buat atau pilih organisasi yang sesuai, lalu buat kunci API. Anthropic memperingatkan bahwa kunci baru hanya ditampilkan sekali, jadi simpanlah kunci tersebut di pengelola rahasia yang disetujui atau lokasi aman lainnya saat kunci tersebut muncul. Jangan cantumkan kunci tersebut dalam tangkapan layar, dokumen yang dibagikan, repositori publik, atau JavaScript di sisi browser.

Simpan kunci tersebut dalam variabel lingkungan

Contoh-contoh tersebut mengharapkan variabel ANTHROPIC_API_KEY. Masukkan nilai sebenarnya hanya di terminal pribadi Anda atau sistem pengelolaan rahasia. Perintah di bawah ini membaca nilai tersebut tanpa menampilkannya di layar, lalu mengekspornya untuk sesi shell saat ini:

baca -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

Variabel lingkungan dapat mengurangi risiko paparan yang tidak disengaja, namun hal tersebut bukanlah strategi pengelolaan rahasia yang lengkap. Aplikasi produksi sebaiknya mengikuti praktik penyimpanan rahasia dan kontrol akses yang diterapkan oleh platform hosting.

Periksa tagihan dan tentukan batas uji yang aman

Penagihan API terpisah dari langganan Claude.ai. Anthropic menyebutkan bahwa sebagian besar organisasi membayar di muka untuk kredit penggunaan, sedangkan organisasi yang menggunakan sistem penagihan bulanan merupakan pengecualian. Pastikan akun Console Anda dapat melakukan permintaan API, lalu buat permintaan pertama dengan volume yang kecil menggunakan max_tokens: 128. Kolom tersebut membatasi jumlah keluaran yang dihasilkan; kolom tersebut tidak mengalokasikan atau menjamin 128 token keluaran yang ditagihkan.

Kirim Permintaan API Claude Pertama Anda dengan cURL

cURL berguna untuk melihat struktur permintaan secara langsung. Contoh di bawah ini menggunakan titik akhir Messages, tipe konten JSON, header kunci API, header versi Anthropic, ID model Quickstart yang telah diverifikasi, dan satu pesan pengguna.

Sebelum Anda menjalankan salah satu contoh tersebut, tambahkan kunci API Anda sendiri dan pastikan bahwa penagihan API telah diaktifkan untuk organisasi tersebut. Kode ini mengikuti format permintaan yang didokumentasikan oleh Anthropic dan telah lulus pemeriksaan sintaks lokal, namun tidak ada respons akun langsung yang disertakan di sini.

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-opus-5",
    "max_tokens": 128,
    "messages": [{
 "role": "user",
 "content": "Jawab dengan satu kalimat yang menjelaskan apa itu API."
    }]
  }'

Fungsi masing-masing header dan bidang JSON

Jika perintah tersebut menghasilkan kesalahan, periksa status HTTP dan jenis kesalahannya sebelum mengubah permintaan. Kesalahan otentikasi dan penagihan memerlukan perbaikan pada akun, sedangkan JSON yang tidak valid atau ID model yang tidak valid memerlukan perubahan pada permintaan.

Kirim Permintaan yang Sama Menggunakan SDK Python

Instal SDK resmi Anthropic

python -m pip install anthropic

Gunakan lingkungan virtual jika hal itu merupakan bagian dari alur kerja Python Anda yang biasa. SDK membaca ANTHROPIC_API_KEY dari lingkungan ketika anthropic.Anthropic() dibuat tanpa kunci yang dinyatakan secara eksplisit.

Jalankan permintaan Python yang setara

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=128,
    messages=[
 {
 "role": "user",
 "content": "Jawab dengan satu kalimat yang menjelaskan apa itu API.",
 }
    ],
)

for block in message.content:
    if block.type == "text":
 print(block.text)

print(message.usage)

Baca teks yang dikembalikan dengan hati-hati

Respons pesan dapat berisi lebih dari satu blok konten, sehingga contoh ini memeriksa tipe masing-masing blok sebelum menampilkan teks. Aplikasi yang sebenarnya juga harus menyimpan ID permintaan untuk keperluan dukungan dan pencatatan tanpa mengungkapkannya ke publik, mencatat model yang dikembalikan beserta alasan penghentian, serta menangani kesalahan API secara eksplisit.

Pertahankan pemeriksaan blok konten meskipun Anda mengharapkan jawaban berupa teks singkat. Hal ini memudahkan perluasan contoh tersebut ketika respons berisi beberapa blok, dan pencetakan penggunaan pesan memberikan angka-angka yang diperlukan untuk perhitungan biaya di bawah ini.

Cara Membaca Penggunaan dan Menghitung Biaya

Temukan teks respons, model, alasan penghentian, dan ID permintaan

Kontrak respons API Pesan mencakup konten yang dihasilkan, model yang menangani permintaan, dan alasan penghentian. Respons HTTP tersebut juga menyertakan pengenal permintaan yang dapat membantu tim dukungan Anthropic melacak masalah. Catat pengenal tersebut dengan cermat; jangan mempublikasikannya bersama konten atau kredensial pelanggan.

Cari penggunaan token input, output, dan cache

The penggunaan Objek ini melaporkan kategori token yang diperlukan untuk analisis biaya. Setidaknya, perhatikan token input dan output. Saat menggunakan penyimpanan cache prompt, pisahkan penulisan cache lima menit, penulisan cache satu jam, dan pembacaan cache karena masing-masing memiliki batas laju yang berbeda. Titik akhir Penghitungan Token Anthropic dapat memperkirakan jumlah token masukan sebelum permintaan, tetapi perkiraan tersebut dapat sedikit berbeda dari penggunaan masukan akhir dan memiliki batas laju tersendiri.

Mengonversi penggunaan token menjadi perkiraan biaya

Hitung setiap kategori secara terpisah, lalu tambahkan hasilnya. Sebagai contoh perencanaan dengan menggunakan Claude Opus 5 pada tarif global standar, 1.000 token masukan yang tidak disimpan dalam cache biayanya 1.000 × $5 / 1.000.000 = $0,005, sedangkan 300 token keluaran berharga 300 × $25 / 1.000.000 = $0,0075. Jumlah perkiraannya adalah $0.0125. Gantilah jumlah token ilustratif ini dengan penggunaan nilai-nilai dari jawaban Anda sendiri.

Kalkulator Harga API Claude

Gunakan kalkulator ini untuk mengubah model, jumlah permintaan, kategori token, mode penagihan, dan wilayah inferensi. Harga pemrosesan batch untuk penggunaan yang memenuhi syarat adalah 50% dengan tarif standar. Inferensi khusus AS menerapkan faktor 1,1x ke semua kategori token untuk model Claude 4.6+ yang memenuhi syarat; Claude Haiku 4.5 tidak memenuhi syarat, sehingga kombinasi tersebut akan menghasilkan status tidak didukung.

Perkiraan ini merupakan panduan perencanaan, bukan faktur. Perkiraan ini tidak mencakup pajak, konversi mata uang, ketentuan yang telah dinegosiasikan, Fast Mode, biaya alat server, dan ketentuan khusus akun. Harga dan syarat kelayakan dapat berubah, jadi harap periksa kembali halaman harga resmi sebelum mengambil keputusan pembelian atau arsitektur.

Kalkulator di atas menunjukkan pola biaya panggilan API Claude yang dapat diprogram dan dibatasi kuotanya. Untuk pekerjaan sehari-hari yang melibatkan beberapa model dan kemampuan AI, GlobalGPT menawarkan nilai yang berbeda: satu langganan menyatukan berbagai model dan alat utama ke dalam satu dasbor, sehingga biaya lebih mudah diperkirakan sekaligus menghindari kebutuhan akan langganan terpisah dan antarmuka yang tersebar untuk kegiatan riset, penulisan, pemrograman, dan pekerjaan kreatif. CLI-nya membawa platform yang sama ke dalam pengembangan berbasis terminal dan alat produksi yang sudah Anda gunakan. Panduan kami tentang bekerja dengan beberapa model AI dalam satu platform menunjukkan bagaimana platform yang lebih luas ini saling terintegrasi.

Kesalahan Umum pada API Claude dan Cara Mengatasinya

Mulailah dengan memeriksa status HTTP dan jenis kesalahan Anthropic, lalu telusuri permintaan tersebut tanpa mengungkapkan kunci. Penjelasan resmi tersebut mempersempit cakupan pencarian; penyebab yang mungkin tetap bergantung pada akun Anda, model yang dipilih, bentuk permintaan, dan lalu lintas.

Urutan debugging yang aman

1. Catat status, jenis kesalahan, cap waktu, dan ID permintaan tanpa mencatat kunci API.
2. Periksa titik akhir, header, sintaks JSON, ID model, dan batas ukuran permintaan.
3. Periksa penagihan organisasi, izin, header pembatasan laju, dan siklus hidup model saat ini.
4. Ulangi hanya kesalahan yang secara wajar dapat dianggap bersifat sementara, dengan menggunakan backoff eksponensial yang dibatasi dan jitter.
5. Jika kesalahan tersebut masih terjadi, persempit permintaan tersebut hingga menjadi kasus terkecil yang dapat direproduksi sebelum menghubungi tim dukungan.

SDK resmi Anthropic secara default akan melakukan percobaan ulang dua kali terhadap kesalahan koneksi, respons 429, dan respons 5xx. Logika percobaan ulang di tingkat aplikasi tetap memerlukan batasan dan pertimbangan idempotensi, terutama ketika suatu permintaan dapat memicu alat atau tindakan eksternal lainnya.

Cara Mengendalikan Biaya API Claude

Tetapkan batas keluaran yang konservatif

Mulailah dari yang terkecil max_token nilai yang masih dapat menghasilkan jawaban yang berguna. Ukur penggunaan keluaran yang sebenarnya sebelum menaikkannya. Prompt yang lebih singkat dapat membantu, tetapi menghapus instruksi yang mencegah upaya ulang, kesalahan, atau keluaran yang tidak dapat digunakan justru dapat menimbulkan biaya yang lebih besar secara keseluruhan.

Gunakan penyimpanan dalam cache prompt dan Batch hanya jika sesuai

• Gunakan penyimpanan dalam cache untuk prompt jika awalan prompt yang sama berulang secara signifikan dan masa berlaku cache sesuai dengan alur kerja.
• Gunakan Batch untuk pekerjaan yang dapat diselesaikan secara asinkron; penggunaan Batch yang memenuhi syarat dikenakan tarif standar sebesar 50%.
• Pisahkan penulisan dan pembacaan cache dalam pelaporan agar penghematan tersebut terlihat jelas, bukan hanya diasumsikan.
• Gunakan inferensi khusus AS hanya jika persyaratan domisili membenarkan faktor harga token sebesar 1,1x dan model yang dipilih memenuhi syarat.

Memantau penggunaan, batas laju, dan batas pengeluaran

Lacak jumlah permintaan, ID model, penggunaan input dan output, kategori cache, upaya ulang, dan kesalahan. Atur peringatan atau batasan pengeluaran yang tersedia bagi organisasi Anda, tetapi jangan berasumsi bahwa tingkatan atau batas akun lain berlaku untuk akun Anda. Panduan lengkap kami mengenai Paket Claude, biaya API, dan batasan mencakup rute penagihan yang lebih luas.

Langkah-Langkah Selanjutnya Setelah Permohonan Pertama Anda

Pilihlah jalur yang tepat untuk proyek Anda berikutnya

Untuk implementasi, lanjutkan dengan referensi resmi Messages API dari Anthropic, panduan streaming, dokumentasi penggunaan alat, halaman siklus hidup model, serta rencana pencatatan dan evaluasi Anda sendiri. Tentukan strategi model dengan cermat, tangani kesalahan sebelum mengalirkan lalu lintas, dan hitung biaya berdasarkan penggunaan yang teramati, bukan hanya berdasarkan panjang prompt saja.

Jika pemrograman adalah tujuan utama Anda, panduan kami tentang menggunakan Claude AI untuk pengkodean membahas cara-cara praktis untuk beralih dari tugas pemrograman interaktif ke alur kerja pengembang yang dapat diulang.

Kapan ruang kerja multi-model menjadi pilihan yang lebih baik

Akses API langsung merupakan pilihan yang tepat jika Anda memerlukan integrasi pada tingkat kode, penagihan bagi pengembang, metadata permintaan, atau kontrol resmi platform. Jika tujuan Anda adalah penulisan interaktif, penelitian, perencanaan, atau membandingkan hasil dari berbagai penyedia tanpa perlu membangun aplikasi, ruang kerja multi-model mungkin lebih praktis.

Pertanyaan yang Sering Diajukan

Apakah API Claude gratis?

Di sini tidak dijanjikan kuota API gratis yang berlaku secara universal. Penggunaan API Claude ditagihkan secara terpisah melalui Claude Console, dan Anthropic menyatakan bahwa sebagian besar organisasi membiayai penggunaannya dengan kredit prabayar, sedangkan organisasi yang ditagih bulanan merupakan pengecualian. Silakan periksa informasi terkini di Console dan informasi harga resmi untuk organisasi Anda sebelum mengirimkan permintaan.

Bagaimana cara mendapatkan kunci API Claude?

Buat kunci di Claude Console untuk organisasi yang bersangkutan. Anthropic memperingatkan bahwa kunci baru tersebut hanya ditampilkan sekali, jadi simpanlah dengan aman saat muncul. Muat kunci tersebut melalui variabel lingkungan sisi server atau pengelola rahasia, dan jangan pernah memaparkannya dalam kode browser, tangkapan layar, atau repositori publik.

ID model Claude mana yang sebaiknya saya gunakan?

Tutorial ini menggunakan claude-opus-5 karena itulah model yang tercantum dalam Panduan Cepat resmi Anthropic saat diverifikasi pada 8 September 2026. Pilihlah model yang sesuai dengan beban kerja dan anggaran Anda, lalu periksa kembali halaman Model dan Model yang Tidak Digunakan Lagi di Anthropic karena ID model, alias, dan status siklus hidupnya dapat berubah.

Endpoint apa yang digunakan oleh API Claude?

Permintaan pertama dalam panduan ini menggunakan titik akhir Messages di https://api.anthropic.com/v1/messages. Permintaan tersebut mengirimkan JSON dengan header content-type, x-api-key, dan anthropic-version. Anthropic juga menyediakan kemampuan API lainnya, jadi gunakan halaman referensi untuk operasi yang sedang Anda implementasikan.

Apakah Claude Pro sudah termasuk kredit API?

Pusat Bantuan No. Anthropic menyatakan bahwa Claude Pro tidak mencakup penggunaan melalui Claude Console. Langganan Claude.ai dan penagihan API merupakan produk terpisah. Atur penagihan API di Console untuk permintaan pengembang, dan gunakan layanan kami Panduan Harga Claude untuk perbandingan rencana yang lebih luas.

Berapa biaya satu permintaan API Claude?

Biaya bergantung pada model yang dipilih, token masukan, token keluaran, penulisan ke cache, pembacaan dari cache, mode Batch, dan wilayah inferensi yang memenuhi syarat. Hitung setiap kategori dengan mengalikan jumlah permintaan dengan jumlah token, lalu mengalikan hasilnya dengan tarif efektif per satu juta token, kemudian bagi dengan satu juta, dan akhirnya jumlahkan semua kategori tersebut. Gunakan kalkulator di atas untuk mendapatkan perkiraan biaya.

Mengapa saya mendapatkan kesalahan 401?

Kode 401 adalah kesalahan otentikasi. Pastikan bahwa kunci API tersebut ada, masih aktif, milik organisasi yang dimaksud, dan terhubung ke server di x-api-key judul. Jangan mencetak atau membagikan kunci tersebut saat melakukan debugging. Upaya ulang yang berulang kali tidak akan memperbaiki kredensial yang hilang atau tidak valid.

Mengapa saya mendapatkan kesalahan 429?

Kode 429 berarti permintaan telah melampaui batas laju. Batas tersebut dapat bervariasi tergantung pada organisasi dan tingkatan penggunaan, jadi periksa header batas laju yang dikembalikan serta Konsol atau dokumentasi terkini. Kurangi jumlah permintaan bersamaan, patuhi interval percobaan ulang, dan gunakan metode "bounded exponential backoff" dengan jitter, alih-alih langsung mengulangi serangkaian permintaan yang sama.

Catatan mengenai asal dan kesegaran: ID model, harga, perilaku API, dan kebijakan dukungan telah diverifikasi berdasarkan dokumentasi resmi Anthropic pada tanggal 8 September 2026. Silakan tinjau halaman model dan harga terkini sebelum menggunakannya dalam lingkungan produksi, kemudian jalankan contoh-contoh tersebut menggunakan kunci Claude Console, pengaturan penagihan, dan akses akun Anda sendiri.