Grok API: integrasi Grok ke dalam kode Anda

Dua cara mengakses Grok dari kode

Developer dapat memanggil model Grok melalui dua cara utama. Pertama adalah xAI API, yang dikelola langsung oleh perusahaannya (kini bernama SpaceXSI), dengan API key dari console.x.ai. Kedua adalah melalui model router seperti OpenRouter, yang menyediakan model dari berbagai penyedia dalam satu kunci dan satu tagihan. Keduanya menerima request dalam format OpenAI Chat Completions, jadi SDK resmi OpenAI bisa langsung digunakan cukup dengan mengubah base URL dan nama modelnya.

Memilih opsi yang tepat

• xAI API jika Anda menginginkan semua fitur Grok terlebih dahulu: daftar model lengkap, Responses API, pencarian web sisi server dan integrasi pencarian X, pembuatan gambar serta video dengan Grok Imagine, suara, batch jobs, serta diskon cached-prompt. Base URL: https://api.x.ai/v1.
• OpenRouter jika Anda ingin berganti-ganti antara Grok dan model dari perusahaan lain tanpa kontrak baru, atau sudah memiliki akun OpenRouter. Base URL: https://openrouter.ai/api/v1, dengan ID model berawalan x-ai/. Panduan penyiapannya ada di panduan cepat OpenRouter.

Apa pun pilihannya, simpan selalu API key di server atau di environment variable. Jangan pernah menyematkannya di dalam halaman web atau aplikasi seluler yang dapat dilihat oleh siapa pun.

Request pertama Anda ke xAI API

Buat kunci di konsol, simpan sebagai XAI_API_KEY, lalu kirim pesan ke Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three tips for a first marathon."}
    ]
  }'

Python, menggunakan library OpenAI

import os
from openai import OpenAI

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

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Is 391 a prime number? Show your check."}],
)
print(answer.choices[0].message.content)

reasoning_effort mengatur seberapa lama model berpikir sebelum menjawab. Grok 4.3 mendukung none, low, medium, high, dan xhigh dengan default low; Grok 4.7 mendukung low, medium, high, dan xhigh dengan default high. Untuk Grok 4.20, xAI merilis ID terpisah: grok-4.20-0309-reasoning dan grok-4.20-0309-non-reasoning.

Melakukan hal yang sama melalui OpenRouter

Di OpenRouter, simpan kunci di OPENROUTER_API_KEY dan gunakan ID berawalan x-ai/. OpenRouter mengatur proses berpikir dengan objek reasoning. Kode JavaScript berikut berjalan di Node.js 18 atau versi lebih baru:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Rewrite this headline in a calmer tone: PRICES EXPLODE AGAIN" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Untuk mengaktifkan proses berpikir model, kirimkan reasoning: { effort: "low" } (atau medium, high). Tambahkan exclude: true jika Anda ingin proses berpikir tetap berjalan namun tidak disertakan dalam output. Pasang stream: true untuk menerima jawaban secara bertahap saat dituliskan, sehingga terasa jauh lebih responsif di antarmuka chat.

Mengirim gambar

Grok 4.20, 4.3, dan 4.7 dapat menganalisis gambar. Gunakan struktur pesan format OpenAI dengan array of parts. Dokumentasi xAI mendukung gambar JPEG dan PNG hingga 20 MiB; Anda bisa menggunakan URL publik maupun data URL base64.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "List the items and the total on this receipt."}
    ]
  }]
}

Daftar model Grok dan harga

Berikut adalah model teks SpaceXAI yang saat ini tercantum di OpenRouter, lengkap dengan ukuran konteks dan harga per sejuta token (daftar harga OpenRouter, Okt 2026). xAI API mengenakan tarif dasar yang sama untuk prompt di bawah 200.000 token.

Beberapa rincian dari halaman model dan harga xAI (daftar harga xAI, Okt 2026):

• Prompt panjang dikenakan biaya lebih tinggi. Begitu prompt mencapai 200.000 token, seluruh request akan ditagih dengan tarif yang lebih tinggi: $4 / $12 untuk Grok 4.7, $2.50 / $5 untuk Grok 4.3 dan 4.20.
• Input ter-cache lebih hemat: $0.50 per sejuta token untuk Grok 4.7 dan $0.20 untuk Grok 4.3 dan 4.20, untuk awalan prompt yang berulang.
• Batch jobs yang tidak memerlukan respons seketika mendapatkan diskon, dan OpenRouter juga menyediakan x-ai/grok-4.3:batch dengan harga $1 / $2.
• Ukuran konteks berbeda antar sumber: OpenRouter mencantumkan 2.000.000 token untuk Grok 4.20, sementara dokumentasi resmi xAI menyebutkan 1.000.000 token.

Token berpikir dihitung sebagai output, sehingga model reasoning bisa menghabiskan biaya per jawaban lebih tinggi daripada perkiraan tarif per token dasarnya.

Tips praktis

• Mulai dengan Grok 4.20 non-reasoning untuk chat biasa, penulisan ulang, dan ekstraksi data. Model ini cepat dan hemat. Beralihlah ke Grok 4.3 atau 4.7 jika kualitas tugas yang rumit lebih diutamakan daripada kecepatan.
• Perhatikan batasan tanggal pengetahuan. Menurut xAI, pengetahuan Grok 4.7 mencakup peristiwa hingga Mei 2026. Untuk informasi yang lebih baru, sertakan faktanya langsung di prompt, atau manfaatkan fitur pencarian web dan X sisi server milik xAI yang ditagih per panggilan.
• Gunakan pesan sistem (system message) untuk menetapkan peran, nada bicara, dan format output yang diinginkan, serta minta output JSON dengan skema khusus jika kode Anda perlu mem-parsing responsnya.
• Tangani rate limits dengan baik. Berikan jeda sejenak sebelum mencoba kembali (retry) saat menerima respons error 429.
• Patuhi ketentuan yang berlaku. Kebijakan penggunaan xAI berlaku untuk pemakaian API, dan Anda dapat memanfaatkan parameter safety_identifier untuk menandai request per pengguna akhir.

Mengatasi masalah yang sering terjadi

• 401 atau 403: API key belum diisi, telah dicabut, atau dimuat di environment yang keliru. Cetak beberapa karakter awal kunci di log server untuk memastikannya terbaca.
• Model not found: periksa penulisan prefix. OpenRouter mewajibkan x-ai/grok-4.7, sementara xAI menggunakan format langsung grok-4.7.
• Respons kosong atau sangat lambat pada model reasoning biasanya menandakan jatah token output habis untuk proses berpikir. Kurangi tingkat reasoning effort atau perbesar nilai max_tokens.
• Gambar ditolak: konversikan formatnya ke JPEG atau PNG dan pastikan ukurannya tidak melebihi batas yang ditentukan.

Tanya Jawab

Apakah Grok API kompatibel dengan SDK OpenAI?

Ya. Anda cukup mengarahkan SDK ke https://api.x.ai/v1 menggunakan API key xAI, atau ke OpenRouter dengan API key OpenRouter, lalu masukkan ID model Grok.

Apakah ada Grok API versi gratis?

Tidak ada paket gratis permanen. Baik xAI maupun OpenRouter mengenakan biaya berbasis penggunaan token, meskipun biaya untuk pengujian singkat tergolong sangat murah.

Bisakah saya membuat gambar menggunakan Grok API?

Bisa, melalui model Grok Imagine milik xAI pada endpoint khusus gambar. Pelajari selengkapnya di halaman Grok Imagine kami. Fitur chat kami saat ini tidak mendukung pembuatan gambar.

Model Grok mana yang digunakan oleh Grok.Online?

Layanan chat kami menyediakan Grok 4.20 tanpa reasoning, Grok 4.3 dengan reasoning effort rendah, serta Grok 4.7 hingga 10 pesan per hari, semuanya diakses melalui OpenRouter.