Grok API: kendi kodunuzdan Grok'u çağırma

Kod ile Grok modellerine erişmenin iki yolu

Geliştiriciler Grok modellerini temelde iki farklı şekilde çağırabilir. Birincisi, bizzat şirketin (şimdiki adıyla SpaceXSI) sunduğu ve anahtarların console.x.ai üzerinden alındığı xAI API'dir. İkincisi ise birçok sağlayıcının modelini tek bir API anahtarı ve tek fatura altında sunan OpenRouter gibi bir model yönlendiricisidir (router). Her iki seçenek de OpenAI Chat Completions biçimindeki istekleri kabul eder; bu sayede temel adresi (base URL) ve model adını değiştirerek resmi OpenAI SDK'lerini hemen kullanabilirsiniz.

Hangi yöntemi seçmelisiniz?

• Her yeni Grok özelliğine ilk siz erişmek istiyorsanız xAI API: Modellerin eksiksiz listesi, Responses API, sunucu taraflı web ve X arama araçları, Grok Imagine ile görsel ve video üretimi, ses özellikleri, toplu (batch) işlemler ve önbelleğe alınmış istem (cached prompt) indirimleri. Temel adres: https://api.x.ai/v1.
• Farklı şirketlerin modelleri ile Grok arasında yeni sözleşmelerle uğraşmadan geçiş yapmak istiyorsanız veya halihazırda bir OpenRouter hesabınız varsa OpenRouter. Temel adres: https://openrouter.ai/api/v1; model kimliklerinin başında x-ai/ ön eki bulunur. Kurulum adımları için OpenRouter hızlı başlangıç kılavuzuna göz atabilirsiniz.

Hangi yolu seçerseniz seçin, anahtarınızı mutlaka sunucu tarafında veya bir ortam değişkeninde (environment variable) saklayın. Herkesin kolayca görebileceği web sayfalarına veya mobil uygulamaların içine API anahtarınızı asla doğrudan eklemeyin.

xAI API ile ilk isteğiniz

Geliştirici konsolunda bir anahtar oluşturup bunu XAI_API_KEY olarak kaydedin ve Grok 4.7 modeline ilk iletinizi gönderin:

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": "İlk maratonum için üç ipucu ver."}
    ]
  }'

Python (OpenAI kütüphanesi ile)

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": "391 bir asal sayı mıdır? Adımlarını göster."}],
)
print(answer.choices[0].message.content)

reasoning_effort parametresi, modelin yanıt vermeden önce ne kadar süre düşüneceğini belirler. Grok 4.3; none, low, medium, high ve xhigh değerlerini kabul eder ve varsayılan olarak low seviyesindedir. Grok 4.7 ise low, medium, high ve xhigh değerlerini destekler; varsayılanı high'dır. Grok 4.20 için xAI iki ayrı model kimliği sunar: grok-4.20-0309-reasoning ve grok-4.20-0309-non-reasoning.

Aynı işlemin OpenRouter ile yapılışı

OpenRouter üzerinde anahtarınızı OPENROUTER_API_KEY değişkenine tanımlayın ve x-ai/ ile başlayan model kimliklerini kullanın. OpenRouter'da düşünme süreci bir reasoning nesnesi ile yönetilir. Node.js 18 ve üzeri sürümlerde çalışan JavaScript örneği:

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: "Şu başlığı daha sakin bir dille yeniden yaz: FİYATLAR YİNE PATLADI" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Modelin düşünmesini sağlamak için reasoning: { effort: "low" } (veya medium, high) değerini gönderin. Düşünce zincirinin yanıtta yer almasını istemiyorsanız exclude: true parametresini ekleyebilirsiniz. Yanıtın yazıldıkça anlık akması için stream: true yapabilirsiniz; bu, sohbet arayüzlerinde çok daha akıcı bir deneyim sunar.

Görsel gönderme

Grok 4.20, 4.3 ve 4.7 modellerinin tümü görsel analizini destekler. OpenAI tarzı çok parçalı mesaj yapısını kullanabilirsiniz. xAI belgelerine göre 20 MiB'a kadar JPEG ve PNG görselleri desteklenir; herkese açık bir URL veya base64 formatında veri adresi (data URL) iletebilirsiniz.

{
  "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": "Bu fişteki kalemleri ve toplam tutarı listele."}
    ]
  }]
}

Grok model kimlikleri ve fiyatları

Aşağıda OpenRouter'ın SpaceXAI için listelediği güncel metin modelleri, bağlam pencereleri ve 1 milyon token başına ücretleri yer almaktadır (OpenRouter liste fiyatı, Ekim 2026). xAI API de 200.000 token altındaki istemler için aynı temel tarifeleri uygular.

xAI'ın modeller ve fiyatlandırma sayfasından bazı önemli ayrıntılar (xAI liste fiyatı, Ekim 2026):

• Uzun istemler daha maliyetlidir. Bir istem 200.000 token sınırına ulaştığında, tüm istek daha yüksek tarifeden faturalandırılır: Grok 4.7 için $4 / $12, Grok 4.3 ve 4.20 için $2.50 / $5.
• Önbelleğe alınan girdiler daha ekonomiktir: Tekrarlanan istem ön eklerinde 1 milyon token başına Grok 4.7 için $0.50, Grok 4.3 ve 4.20 için $0.20 ücret alınır.
• Toplu işler (batch jobs) aciliyeti olmayan durumlarda indirim sağlar; OpenRouter ayrıca x-ai/grok-4.3:batch modelini $1 / $2 fiyatıyla listeler.
• Bağlam boyutu kaynağa göre değişebilir: Grok 4.20 için OpenRouter 2.000.000 token belirtirken, xAI'ın kendi model sayfası 1.000.000 token olarak listeler.

Düşünme (reasoning) token'ları çıktı olarak faturalandırılır; bu nedenle akıl yürüten bir model, yanıt başına token başı birim fiyatının ima ettiğinden daha yüksek maliyet çıkarabilir.

Pratik ipuçları

• Sohbet, yeniden yazma ve veri ayıklama için Grok 4.20 non-reasoning ile başlayın. Hızlı ve ekonomiktir. Hızdan ziyade zorlu görevlerde kalite ön plana çıktığında Grok 4.3 veya 4.7 modellerine geçebilirsiniz.
• Bilgi kesilme tarihini unutmayın. xAI verilerine göre Grok 4.7, Mayıs 2026'ya kadarki gelişmeleri bilir. Daha yeni olaylar için bilgileri isteminizde iletin veya xAI'ın çağrı başına ücretlendirilen sunucu taraflı web ve X arama araçlarını kullanın.
• Sistem mesajı tanımlayın. İstenen rolü, üslubu ve çıktı biçimini açıkça belirtin; kodunuz çıktıyı ayrıştıracaksa şema tanımlı JSON formatında yanıt isteyin.
• Hız sınırlarını (rate limit) yönetin. 429 yanıtı aldığınızda kısa bir beklemenin ardından isteği yeniden deneyen bir mekanizma kurun.
• Kurallara uyun. xAI'ın kabul edilebilir kullanım politikası API için de geçerlidir; safety_identifier alanı ile istekleri son kullanıcı bazında etiketleyebilirsiniz.

Bir sorunla karşılaştığınızda

• 401 veya 403 hatası: Anahtar eksik, iptal edilmiş veya yanlış ortama yüklenmiş olabilir. Sunucunuzda anahtarın ilk birkaç karakterini yazdırarak doğruluğunu teyit edin.
• Model bulunamadı hatası: Model adının ön ekini kontrol edin. OpenRouter x-ai/grok-4.7 biçimini, xAI ise yalın grok-4.7 biçimini bekler.
• Boş veya çok yavaş yanıtlar: Akıl yürütme modelinde bu durum genellikle çıktı kotasının tamamının düşünme aşamasında tükendiğini gösterir. Efor seviyesini düşürün veya max_tokens sınırını artırın.
• Görsel reddedildi: Görseli JPEG veya PNG formatına dönüştürüp dosya boyutu sınırının altında tuttuğunuzdan emin olun.

Sıkça Sorulan Sorular

Grok API, OpenAI SDK ile uyumlu mu?

Evet. SDK'nin adresini xAI anahtarıyla https://api.x.ai/v1 veya OpenRouter anahtarıyla OpenRouter olarak belirleyip bir Grok model kimliği kullanmanız yeterlidir.

Ücretsiz bir Grok API var mı?

Kalıcı bir ücretsiz katman bulunmamaktadır. Kısa testlerin maliyeti çok düşük olsa da hem xAI hem de OpenRouter token başına ücretlendirme yapar.

Grok API ile görsel üretebilir miyim?

Evet, xAI'ın ayrı bir görsel uç noktasında çalışan Grok Imagine modelleri aracılığıyla görsel üretebilirsiniz. Ayrıntılar için Grok Imagine sayfamıza göz atabilirsiniz. Web sitemizdeki sohbet arayüzü görsel üretimi yapmamaktadır.

Grok.Online hangi Grok modelini kullanıyor?

Sohbet arayüzümüz, tamamı OpenRouter üzerinden sunulan; düşünme özelliği kapalı Grok 4.20, düşük akıl yürütme seviyesinde Grok 4.3 ve günde en fazla 10 mesaja kadar Grok 4.7 modellerini kullanır.