Grok API: integrasi Grok ke dalam kod anda

Dua cara mengakses Grok melalui kod

Pembangun boleh memanggil model Grok melalui dua cara utama. Yang pertama ialah API xAI, yang dikendalikan oleh syarikat itu sendiri (kini di bawah jenama SpaceXSI), dengan kunci daripada console.x.ai. Yang kedua ialah penghala model (model router) seperti OpenRouter, yang menggabungkan model daripada pelbagai penyedia di bawah satu kunci dan satu bil. Kedua-duanya menerima permintaan dalam format OpenAI Chat Completions, jadi SDK rasmi OpenAI boleh digunakan sebaik sahaja anda menukar alamat asas dan nama model.

Pilihan mana yang patut dipilih

• API xAI jika anda mahukan setiap ciri Grok yang terbaharu terlebih dahulu: senarai penuh model, Responses API, carian web bahagian pelayan dan alat carian X, penjanaan imej serta video dengan Grok Imagine, suara, kerja kelompok (batch jobs) dan diskaun cache prom. URL Asas https://api.x.ai/v1.
• OpenRouter jika anda mahu beralih antara Grok dan model daripada syarikat lain tanpa kontrak baharu, atau sudah mempunyai akaun OpenRouter. URL Asas https://openrouter.ai/api/v1, dengan id model berawalan x-ai/. Panduan persediaan ada dalam panduan permulaan pantas OpenRouter.

Walau apa pun pilihan anda, simpan kunci tersebut di pelayan atau dalam pemboleh ubah persekitaran (environment variable). Jangan sekali-kali menyertakannya di dalam kod halaman web atau aplikasi mudah alih, kerana ia boleh dilihat oleh sesiapa sahaja.

Permintaan pertama anda ke API xAI

Cipta kunci dalam konsol, simpannya sebagai XAI_API_KEY, dan hantar mesej kepada 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, dengan pustaka 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 mengawal tempoh masa model berfikir sebelum membalas. Grok 4.3 menerima none, low, medium, high dan xhigh serta ditetapkan kepada low secara lalai; Grok 4.7 menerima low, medium, high dan xhigh serta ditetapkan kepada high secara lalai. Bagi Grok 4.20, xAI menyediakan id berasingan: grok-4.20-0309-reasoning dan grok-4.20-0309-non-reasoning.

Perkara yang sama melalui OpenRouter

Pada OpenRouter, simpan kunci dalam OPENROUTER_API_KEY dan gunakan id berawalan x-ai/. OpenRouter mengawal penaakulan melalui objek reasoning. Kod JavaScript ini berfungsi pada Node.js 18 atau yang lebih baharu:

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 pemikiran model, hantarkan reasoning: { effort: "low" } (atau medium, high). Tambahkan exclude: true jika anda mahu pemikiran tersebut digunakan tetapi tidak dipaparkan dalam jawapan. Tetapkan stream: true untuk menerima jawapan secara masa nyata semasa ia ditulis, yang terasa jauh lebih pantas dalam antara muka sembang.

Menghantar imej

Grok 4.20, 4.3 dan 4.7 semuanya menyokong input imej. Gunakan struktur mesej gaya OpenAI dengan senarai bahagian. Dokumentasi xAI menyokong imej JPEG dan PNG sehingga 20 MiB; URL awam mahupun data URL base64 kedua-duanya boleh digunakan.

{
  "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."}
    ]
  }]
}

Id model Grok dan harga

Berikut ialah model teks semasa yang disenaraikan oleh OpenRouter untuk SpaceXAI, bersama saiz konteks dan harga bagi setiap sejuta token (harga senarai OpenRouter, Okt 2026). API xAI mengenakan kadar asas yang sama untuk prom di bawah 200,000 token.

Beberapa perincian daripada halaman model dan harga xAI (harga senarai xAI, Okt 2026):

• Prom panjang lebih mahal. Sebaik sahaja prom mencecah 200,000 token, keseluruhan permintaan dibilkan pada kadar yang lebih tinggi: $4 / $12 untuk Grok 4.7, $2.50 / $5 untuk Grok 4.3 dan 4.20.
• Input dicache lebih murah: $0.50 setiap sejuta token untuk Grok 4.7 dan $0.20 untuk Grok 4.3 dan 4.20, bagi awalan prom yang berulang.
• Kerja kelompok (batch jobs) yang tidak memerlukan respons serta-merta mendapat diskaun, dan OpenRouter turut menyenaraikan x-ai/grok-4.3:batch pada kadar $1 / $2.
• Konteks berbeza mengikut sumber: OpenRouter menyenaraikan 2,000,000 token untuk Grok 4.20, manakala halaman model xAI sendiri menyatakan 1,000,000.

Token pemikiran dikira sebagai output, jadi model penaakulan boleh memakan kos yang lebih tinggi bagi setiap jawapan berbanding anggaran harga per token biasa.

Tip praktikal

• Mulakan dengan Grok 4.20 non-reasoning untuk sembang, penulisan semula dan pengekstrakan data. Ia pantas dan menjimatkan. Beralih ke Grok 4.3 atau 4.7 apabila kualiti tugasan yang rumit lebih diutamakan berbanding kepantasan.
• Ambil kira batas pengetahuan (knowledge cut-off). Menurut xAI, pengetahuan Grok 4.7 terhad kepada peristiwa sehingga Mei 2026. Untuk maklumat yang lebih baharu, sertakan fakta tersebut dalam prom anda, atau gunakan alat carian web dan X bahagian pelayan xAI, yang dibilkan bagi setiap panggilan.
• Tulis mesej sistem yang menetapkan peranan, nada dan format output yang diingini, dan minta format JSON berserta skema jika kod anda perlu menghurai respons tersebut.
• Kendalikan had kadar (rate limits). Cuba semula selepas jeda pendek apabila anda menerima respons 429.
• Patuhi peraturan. Dasar penggunaan xAI terpakai untuk penggunaan API, dan medan safety_identifier membolehkan anda menandakan permintaan bagi setiap pengguna akhir.

Apabila timbul masalah

• 401 atau 403: kunci hilang, telah dibatalkan atau dimuatkan ke dalam persekitaran yang salah. Cetak beberapa aksara pertama kunci di pelayan untuk memastikan ia wujud.
• Model tidak ditemui: semak awalan. OpenRouter memerlukan x-ai/grok-4.7, manakala xAI menggunakan grok-4.7 sahaja.
• Jawapan kosong atau sangat perlahan daripada model penaakulan biasanya bermaksud ia telah menghabiskan bajet output untuk berfikir. Kurangkan tahap penaakulan (effort) atau tingkatkan nilai max_tokens.
• Imej ditolak: tukarkannya kepada JPEG atau PNG dan pastikan saiznya tidak melebihi had.

Soalan Lazim (FAQ)

Adakah API Grok serasi dengan SDK OpenAI?

Ya. Halakan SDK ke https://api.x.ai/v1 dengan kunci xAI, atau ke OpenRouter dengan kunci OpenRouter, dan gunakan id model Grok.

Adakah terdapat API Grok percuma?

Tiada pelan percuma kekal yang ditawarkan. Kedua-dua xAI dan OpenRouter mengenakan bayaran mengikut token, walaupun ujian ringkas memerlukan kos yang sangat kecil.

Bolehkah saya menjana imej menggunakan API Grok?

Boleh, melalui model Grok Imagine daripada xAI pada titik akhir imej yang berasingan. Sila rujuk halaman Grok Imagine kami. Ruang sembang kami tidak menjana imej.

Model Grok manakah yang digunakan oleh Grok.Online?

Ruang sembang kami menawarkan Grok 4.20 tanpa penaakulan, Grok 4.3 dengan tahap penaakulan rendah, dan Grok 4.7 sehingga 10 mesej sehari, semuanya melalui OpenRouter.