Cara Mendapatkan Kunci API Grok dan Melakukan Panggilan Pertama (Grok 4.6)

Kunci API Grok adalah kredensial yang dikeluarkan xAI dari konsol pengembangnya sehingga kode Anda dapat memanggil model Grok melalui HTTPS. Anda membuatnya sekali, mengirimkannya sebagai token Bearer di setiap permintaan, dan xAI menagih token yang Anda gunakan terhadap kredit prabayar tim Anda. Jika konsep ini baru, apa itu kunci API mencakup dasar-dasarnya; panduan ini untuk pengembang yang ingin kunci API berfungsi hari ini.

Berikut urutannya: buat kunci di console.x.ai, buat satu permintaan dengan curl dan satu dengan Python, lalu pindahkan kunci ke Apidog agar Anda dapat menyimpannya dengan aman, mengirim permintaan tanpa menempelkannya ke shell, dan mengubah permintaan pertama itu menjadi tes yang disimpan. Model unggulan saat ini adalah grok-4.6, dan setiap contoh di bawah ini menggunakannya.

button

Yang Anda perlukan sebelum memulai

Akun xAI. Daftar di console.x.ai.

Kredit di akun. Konsol berjalan dengan kredit prabayar, dan panduan cepat resmi menyarankan Anda untuk memuat kredit segera setelah mendaftar. Dengan saldo nol, permintaan akan ditolak.
curl (dilengkapi dengan macOS dan sebagian besar distro Linux) dan Python 3.9 atau yang lebih baru dengan pip.
Apidog jika Anda ingin permintaan disimpan, diuji, dan dibagikan. Paket gratis mencakup 4 pengguna, yang cukup untuk tim kecil. Unduh Apidog sebelum Langkah 4.

Langkah 1: buat kunci di konsol xAI

Masuk dan buka Penagihan. Di bawah manajemen pengeluaran API, beli kredit dengan kartu (akan langsung masuk) atau transfer bank (dua hingga tiga hari kerja, sesuai dokumen penagihan).
Buka halaman Kunci API. Panduan cepat menautkannya di console.x.ai/team/default/api-keys. Segmen team penting: kunci adalah milik tim, bukan login pribadi Anda.
Klik Buat Kunci API dan berikan nama yang akan Anda kenali dalam enam bulan. "apidog-local-dev" lebih baik daripada "key1".
Salin kunci segera setelah dibuat. Perlakukan ini sebagai satu-satunya saat Anda akan melihat nilai penuhnya.
Simpan sebagai variabel lingkungan daripada di dalam kode:

export XAI_API_KEY="tempel-kunci-anda-di-sini"

XAI_API_KEY adalah nama variabel yang digunakan oleh dokumen resmi, sehingga SDK xAI sendiri dan sebagian besar integrasi komunitas akan mengambilnya tanpa konfigurasi tambahan.

Satu kunci per lingkungan adalah kebiasaan yang baik. Kunci terpisah untuk pengembangan lokal, CI, dan produksi berarti kunci laptop yang bocor dapat dihapus tanpa menyentuh hal lain.

Langkah 2: lakukan panggilan pertama Anda dengan curl

Endpoint teks utama xAI adalah POST https://api.x.ai/v1/responses. Kirim kunci di header Authorization, JSON di body, dan id model di bidang model:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "instructions": "Anda adalah seorang insinyur backend senior. Jawab dalam tiga kalimat.",
    "input": "API saya mengembalikan 429 ke klien yang mencoba lagi secara instan. Apa yang harus diubah klien?"
  }'

Respons yang berhasil adalah JSON dengan array output. Teks berada di output[].content[].text dengan "type": "output_text", dan objek usage melaporkan input_tokens, output_tokens, dan total_tokens, ditambah rincian untuk token penalaran dan cache. Angka penggunaan tersebut adalah dasar penagihan Anda, jadi catatlah sejak hari pertama.

Dua detail yang perlu diketahui:

instructions adalah prompt sistem. Anda juga dapat meneruskan input sebagai array pesan {role, content} jika Anda lebih suka bentuk obrolan.
Jika Anda memiliki kode gaya OpenAI yang sudah ada, POST https://api.x.ai/v1/chat/completions masih berfungsi dengan kunci dan id model yang sama. xAI melabelinya sebagai endpoint lama dan mengirimkan fitur baru ke Responses terlebih dahulu, jadi mulailah proyek baru di /v1/responses.

Untuk streaming, panggilan alat (tool calls), dan input gambar pada endpoint yang sama ini, lihat cara menggunakan API Grok 4.6.

Langkah 3: panggilan yang sama dari Python

API REST xAI kompatibel dengan OpenAI SDK, jadi Anda tidak memerlukan pustaka klien baru. Arahkan base_url ke xAI dan baca kunci dari lingkungan:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.6",
    instructions="Anda adalah seorang insinyur backend senior. Jawab dalam tiga kalimat.",
    input="API saya mengembalikan 429 ke klien yang mencoba lagi secara instan. Apa yang harus diubah klien?",
)

print(response.output_text)
print(response.usage.input_tokens, response.usage.output_tokens)

Instal SDK dengan pip install openai. Membaca os.environ["XAI_API_KEY"] akan memunculkan KeyError yang jelas jika variabel tidak ada, yang lebih baik daripada mengirim header Bearer kosong dan men-debug 401.

xAI juga menerbitkan SDK Python asli (xai-sdk) dengan transport gRPC dan fitur tambahan seperti Collections dan Voice API. Untuk panggilan pertama, klien OpenAI adalah jalur yang lebih singkat.

Langkah 4: simpan dan uji kunci di Apidog

Menempelkan kunci ke terminal berfungsi sekali. Berbagi permintaan dengan rekan tim, menjalankannya kembali setelah pembaruan model, atau memasukkannya ke CI adalah tempat klien API menunjukkan nilainya. Berikut alurnya di Apidog.

Simpan kunci sebagai nilai lokal. Buka Environments, buat satu bernama "xAI", dan tambahkan dua variabel: baseUrl dengan nilai bersama https://api.x.ai/v1, dan XAI_API_KEY dengan placeholder sebagai nilai bersamanya dan kunci asli Anda dalam nilai lokalnya. Nilai bersama disinkronkan ke rekan tim; nilai lokal tetap berada di cache klien Anda di mesin Anda dan tidak pernah mencapai server Apidog. Nama variabel dikirim dengan proyek, rahasianya tidak. Lingkungan Apidog dan variabel rahasia mencakup perpecahan antara bersama-versus-lokal secara mendalam, termasuk bagaimana CI menyuntikkan kuncinya sendiri.

Kirim permintaan pertama. Buat endpoint baru: POST {{baseUrl}}/responses. Pada tab Auth pilih Bearer Token dan masukkan {{XAI_API_KEY}}. Tempelkan badan JSON dari Langkah 2, pilih lingkungan xAI, dan tekan Kirim. Panel respons menunjukkan status, waktu, dan badan yang diurai, sehingga Anda dapat mengklik output dan usage alih-alih membaca JSON mentah.

Simpan sebagai tes. Di Post Processors, tambahkan langkah Assert: kode status sama dengan 200, dan pemeriksaan JSONPath bahwa $.model sama dengan grok-4.6. Tambahkan pernyataan kedua bahwa $.usage.output_tokens lebih besar dari 0. Simpan endpoint, buka Tests, buat skenario tes, dan impor endpoint tersebut ke dalamnya. Sejak saat itu, satu klik akan menjalankan kembali panggilan dan memberi tahu Anda apakah kunci, id model, dan bentuk respons masih berfungsi.

Opsional: tirukan (mock) itu. Simpan respons asli sebagai contoh di endpoint dan beralih ke URL tiruan Apidog. Pekerjaan front-end dan unit test dapat berjalan terhadap respons Grok palsu tanpa menghabiskan kredit atau mencapai batas kecepatan.

Batas, kredit, dan harga

Penagihan. Kredit prabayar per tim. Top-up otomatis dapat membeli lebih banyak ketika saldo Anda turun di bawah ambang batas yang Anda tetapkan (minimum $5 per top-up), dengan batas bulanan dan peringatan pada 80% dari batas tersebut. Penagihan bulanan ada tetapi dinonaktifkan secara default dan melalui penjualan xAI; dengan batas penagihan $0 default, permintaan akan ditolak saat kredit prabayar habis.

Harga Grok 4.6 per juta token, dari halaman harga resmi:

Ukuran Prompt	Input	Input Cache	Output
Di Bawah 200k token	$2.00	$0.50	$6.00
200k token atau lebih	$4.00	$1.00	$12.00

Jendela konteks adalah 500k token. Permintaan yang prompt-nya melewati ambang batas 200k akan ditagih dengan tarif yang lebih tinggi untuk semua tokennya, bukan hanya yang melebihi batas.

Batas kecepatan. xAI membatasi permintaan per detik dan token per menit. Angka-angka tergantung pada tingkatan Anda: lima tingkatan (0 hingga 4) ditambah Enterprise, dibuka secara otomatis berdasarkan pengeluaran kumulatif sejak 1 Januari 2026, dan tingkatan tidak pernah diturunkan. Batas tim Anda saat ini ada di halaman Model di konsol. Setiap token dihitung terhadap TPM, termasuk token penalaran dan token prompt yang di-cache.

Kredit gratis. Dokumen xAI menjelaskan model prabayar dan tidak mengiklankan tingkatan gratis yang tetap untuk API. Kredit promosi telah muncul di konsol pada waktu tertentu; periksa halaman Penagihan Anda sendiri daripada mengandalkan posting blog.

Kesalahan umum dan cara memperbaikinya

401 Unauthorized. Kunci hilang, salah format, atau dihapus. Periksa header yang bertuliskan Authorization: Bearer <key> dengan satu spasi, bahwa $XAI_API_KEY diatur di shell yang menjalankan curl (echo $XAI_API_KEY | wc -c harus mencetak lebih dari 1), dan bahwa kunci masih ada di konsol. Baris baru di akhir dari copy-paste adalah penyebab klasik.

403 Forbidden. Kunci valid tetapi tidak diizinkan untuk melakukan apa yang Anda minta. Alasan yang mungkin: kunci atau tim diblokir, kredit habis dengan batas penagihan $0, atau tim tidak memiliki akses ke model. Periksa Penagihan terlebih dahulu, lalu kunci di halaman Kunci API.

429 Too Many Requests. Anda telah mencapai batas RPS atau TPM untuk tingkatan Anda. Tambahkan *exponential backoff* dengan *jitter*, batasi *concurrency*, pangkas ukuran prompt, dan pindahkan pekerjaan massal ke Batch API. Jika Anda berada di batas sepanjang hari, solusinya adalah meningkatkan tingkatan pengeluaran, bukan kode.

400 Bad Request. Biasanya id model yang salah (grok-4.6, bukan grok-4-6) atau JSON yang tidak valid. Isi error akan menyebutkan bidangnya.

Panduan lengkap tentang membaca respons ini, termasuk streaming dan kegagalan panggilan alat, ada di cara menguji dan men-debug permintaan API Grok 4.6.

FAQ

Apakah ada kunci API Grok gratis?

Bukan sebagai penawaran resmi yang didokumentasikan. API berjalan dengan kredit prabayar, dan panduan cepat menyarankan Anda untuk memuat kredit sebelum panggilan pertama. Jika tujuan Anda adalah mencoba Grok daripada membangun di atasnya, cara menggunakan Grok secara gratis mencakup rute konsumen yang tidak memerlukan kunci.

Apakah kunci API Grok berfungsi dengan OpenAI SDK?

Ya. Setel base_url="https://api.x.ai/v1" dan teruskan kunci xAI Anda sebagai api_key. Baik client.responses.create() maupun client.chat.completions.create() yang lama berfungsi dengan model="grok-4.6".

ID model mana yang harus saya masukkan dalam permintaan?

grok-4.6 untuk model unggulan. Alias grok-4.6-latest melacak revisi terbaru. ID yang lebih lama seperti grok-4.5 dan grok-4.3 tetap terdaftar dengan harganya sendiri, tetapi pekerjaan baru harus dimulai pada 4.6.

Apa yang harus saya lakukan jika kunci saya bocor?

Segera hapus di halaman Kunci API, buat penggantinya, dan perbarui variabel lingkungan di mana pun itu digunakan. Kemudian cari di repositori Anda dan log CI untuk nilai lama. Pada paket Apidog Enterprise, Secret Scanner menandai kunci yang ada di permintaan, variabel, skrip, dan dokumen, yang menangkap kasus di mana seseorang menempelkan kunci ke nilai bersama alih-alih nilai lokal.

Langkah selanjutnya

Anda sekarang memiliki kunci API Grok yang berfungsi, panggilan curl dan Python yang berhasil, dan permintaan yang disimpan di Apidog sebagai tes yang dapat diulang. Arahkan tes tersebut ke prompt asli Anda, perhatikan angka usage, dan Anda akan mengetahui pengeluaran serta batas kecepatan Anda sebelum lalu lintas produksi terjadi.