Grok 4.7 API Nasıl Kullanılır?

Grok 4.7'yi çağırmak için, https://api.x.ai/v1/responses adresine bir POST isteği gönderin, isteğe "model": "grok-4.7"'yi ve xAI anahtarınızı bir Bearer token olarak ekleyin. 200.000 token altındaki istemler için milyon giriş tokeni başına 2 dolar, milyon önbelleğe alınmış giriş tokeni başına 0,50 dolar ve milyon çıkış tokeni başına 6 dolar maliyeti vardır, 500.000 tokenlik bir bağlam penceresiyle. SpaceXAI (eski adıyla xAI şirketi) bunu 21 Eylül 2026'da Grok 4.6 ile aynı fiyata piyasaya sürdü, bu nedenle çoğu mevcut entegrasyon için yükseltme tek satırlık bir değişikliktir.

Aşağıda: ilk istek, akıl yürütme çabası ve faturanıza etkisi, şifreli akıl yürütme, önbellekleme, akış, araçlar, oran sınırlamaları ve Apidog'da yeniden kullanılabilir bir test kurulumu bulunmaktadır. Model hakkında bilgi için Grok 4.7'nin ne olduğunu ve nelerin değiştiğini okuyun; resmi referans ise xAI belgelerindeki Grok 4.7 sayfasıdır.

Bir Bakışta Grok 4.7 API

Adım 1: Bir anahtar alın ve kredi yükleyin

console.x.ai adresinde bir hesap oluşturun, kredi yükleyin (API ön ödemelidir) ve bir anahtar oluşturun. Grok API anahtarı rehberimiz konsol ekranlarında yol gösterir. Anahtarı kodunuzdan uzak tutun:

export XAI_API_KEY="your-key-here"

Adım 2: İlk isteğinizi yapın

Yanıtlar API'si birincil uç noktadır ve xAI belgelerindeki her örnek bunu kullanır:

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4.7",
    "input": "Review this function for bugs: function median(a){a.sort();return a[a.length/2]}"
  }'

API, OpenAI SDK ile çalışır. İstemciyi xAI'nin temel URL'sine yönlendirin ve responses.create çağrısını yapın:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: "https://api.x.ai/v1",
});

const response = await client.responses.create({
  model: "grok-4.7",
  reasoning: { effort: "medium" },
  input: [
    { role: "system", content: "You are a senior backend reviewer." },
    { role: "user", content: "Find the bug in: function median(a){a.sort();return a[a.length/2]}" },
  ],
});

console.log(response.output_text);

Başka bir istemciyi tercih ediyorsanız, aynı model xAI'nin Python SDK'sında (xai_sdk) grok-4.7, Vercel AI SDK'sında xai.responses('grok-4.7') ve LiteLLM'de xai/grok-4.7'dir. İki uyumluluk notu: xAI artık Chat Completions'ı eski bir uç nokta olarak etiketlemektedir ve Anthropic SDK uyumluluğu tamamen kullanımdan kaldırılmıştır. Yeni kod /v1/responses'ı hedeflemelidir.

Adım 3: Bir akıl yürütme çabası seçin

Grok 4.7 her zaman akıl yürütür. Bunu kapatamazsınız, ancak Yanıtlar API'sinde reasoning.effort (xAI SDK'sında reasoning_effort) ile ne kadar yoğun düşüneceğini kontrol edersiniz: gecikmeye duyarlı araç çağrıları için low, analiz ve uzun bağlam için medium, zor çok adımlı problemler için high (varsayılan) ve kalitenin yanıt süresinden önemli olduğu durumlarda xhigh.

Bu ayar, faturanız üzerindeki en büyük kaldıraçtır. SpaceXAI'nin yayın sayfasında çaba düzeyine göre CursorBench 4.0 sonuçları yayınlanmaktadır ve fark geniştir:

low'dan xhigh'a geçmek 13.2 puan kazandırır ve görev başına yaklaşık 3.8 kat daha fazla maliyetlidir, çünkü model yaklaşık 4.5 kat daha fazla çıkış tokeni yazar. medium ile başlayın ve bir rotayı ancak kendi testleriniz ek kalitenin önemli olduğunu gösterdiğinde yükseltin.

Bir kısıtlama daha: akıl yürütme modelleri presencePenalty, frequencyPenalty ve stop'u reddeder. Eski bir sarmalayıcı bunlardan herhangi birini hala gönderiyorsa, istek bir hata döndürür.

Adım 4: Çok turlu çağrılarda şifreli akıl yürütmeyi ele alın

Bu, sizi en çok şaşırtması muhtemel davranış değişikliğidir. Yanıtlar API'sinde, grok-4.7, include listeniz bunu istemese bile her zaman reasoning.encrypted_content döndürür. Akıl yürütmeyi okuyamazsınız, ancak ileriye taşıyabilirsiniz.

Çok turlu konuşmalar için, önceki yanıttaki akıl yürütme öğelerini bir sonraki isteğin input kısmında değişmeden geri iletin. Bu, modelin akıl yürütmesini turlar boyunca sağlam tutar. Bu öğeleri düzenlemeyin, kırpmayın veya yeniden sıralamayın. Kodunuz, bir sonraki turu oluşturmadan önce output dizisini message öğelerine göre filtreliyorsa, Grok 4.7'nin geri almayı beklediği bağlamı artık atar. Chat Completions davranışı değişmemiştir.

Adım 5: Önbelleklemenin sizin için çalışmasını sağlayın

Önbelleğe alınmış giriş, yeni giriş için 2 dolara karşılık milyon token başına 0,50 dolara mal olur, bu %75'lik bir indirimdir. Ancak: bir önbellek isabeti, isteğinizin zaten öneki tutan bir sunucuya ulaşmasını gerektirir. SpaceXAI, Yanıtlar API çağrılarında (veya Chat Completions'da x-grok-conv-id başlığında) prompt_cache_key ayarlamayı "şiddetle tavsiye eder". Bu, bir konuşmanın isteklerini aynı sunucuya yönlendirir; bu olmadan xAI, önbellek soğuk bir sunucuda genellikle tam giriş fiyatı ödediğiniz konusunda uyarır.

İstemi yeniden kullanım için sıralayın: önce sistem istemi, araç şemaları ve referans belgeleri, en son yeni kullanıcı mesajı. Başlangıca yakın değişen her şey öneki ve dolayısıyla indirimi bozar.

Adım 6: Yanıtları akışla alın

Sonunda tek bir JSON gövdesi yerine sunucu tarafından gönderilen olayları almak için "stream": true ekleyin. Akıl yürütme her zaman açık olduğundan, model ilk yanıt tokeninden önce bir süre düşünebilir ve akışsız bir çağrı takılıp kalmış gibi görünebilir veya kısa bir HTTP zaman aşımına neden olabilir. Grok 4.7 akıl yürütme özetlerini akışla sağlar, böylece model düşünürken ilerlemeyi gösterebilirsiniz.

Fonksiyon çağrıları istisnadır: xAI belgelerine göre, bir fonksiyon çağrısı tek bir yığın halinde tamamen gelir. Argümanları deltalar yerine, bu yığın geldiğinde ayrıştırın. SSE üzerinden akış yapan LLM API'lerini test etme rehberimiz, Apidog'da ham olay dizisini nasıl inceleyeceğinizi gösterir.

Adım 7: Araçları ekleyin

Fonksiyon çağırma, Yanıtlar API aracı formatını kullanır. Fonksiyonu tanımlarsınız, Grok bir function_call öğesi döndürür, siz onu çalıştırırsınız ve eşleşen call_id ile bir function_call_output geri gönderirsiniz:

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4.7",
    "input": [{"role": "user", "content": "Has order 10482 shipped yet?"}],
    "tools": [{
      "type": "function",
      "name": "get_order_status",
      "description": "Look up the fulfillment status of an order",
      "parameters": {
        "type": "object",
        "properties": { "order_id": {"type": "string"} },
        "required": ["order_id"]
      }
    }]
  }'

Yapılandırılmış çıktılar da desteklenir, böylece nihai yanıtı bir JSON şemasına göre tutabilirsiniz.

Sunucu taraflı araçlar xAI tarafında çalışır: {"type": "web_search"}, X araması ve kod yürütme. Bunlar tokenlere ek olarak ücretlendirilir: web araması 1.000 çağrı başına 5 dolar, X araması 1.000 gönderi başına 5 dolar ve kod yürütme 1.000 çağrı başına 5 dolar, dolayısıyla her turda arama yapan bir aracı her turda bu ücreti öder. Web araması allowed_domains ve excluded_domains'i (her biri en fazla beş tane) kabul eder. Bir arama aracı olmadan, Grok 4.7'nin canlı verisi yoktur; bilgisi Mayıs 2026'da sona ermektedir.

200 bin fiyatlandırma uçurumuna dikkat edin

Fiyat tablosunun iki satırı olmasının bir nedeni var. Bir istem 200.000 tokene ulaştığında, tüm istek daha yüksek orandan faturalandırılır: 4 dolar giriş, 1 dolar önbelleğe alınmış, 12 dolar çıkış. Sadece hattın üzerindeki tokenler daha pahalı değildir.

4.000 tokenlik bir yanıtla birlikte 190.000 tokenlik bir istem yaklaşık 0,40 dolara mal olur. Aynı yanıtla birlikte 210.000 tokenlik bir istem yaklaşık 0,89 dolara mal olur. Yaklaşık %10 daha fazla giriş, faturayı iki katından fazla artırır.

Göndermeden önce tokenleri sayın, bir konuşma sınıra yaklaştıkça geçmişi özetleyin ve uzun aracı döngüleri için xAI'nin bağlam sıkıştırmasını kullanın. 500.000 tokenlik pencerenin ucuz kısmı 200.000'de biter.

Oran sınırlamaları ve 429'lar

Limitler, kümülatif harcamanızla ölçeklenir ve Grok 4.6'nınkilerle eşleşir:

Önbelleğe alınmış tokenler, dakika başına tokenlere dahil edilir. Aşıldığında HTTP 429 alırsınız. Uç noktayı sürekli zorlamak yerine üstel geri çekilme ve titreşim ile yeniden deneyin; oran limiti aşıldı hatalarına ilişkin rehberimiz bu kalıpları kapsar.

Grok 4.6'dan Geçiş

Çoğu entegrasyonun tek bir değişikliğe ihtiyacı var: grok-4.6, grok-4.7 olur. Fiyat, bağlam penceresi, oran sınırlamaları ve çaba düzeyleri aynıdır. Üretim trafiğini taşımadan önce üç şeyi yeniden test edin:

• Çok turlu işlem. Kodunuzun şifreli akıl yürütme öğelerini değişmeden geri ilettiğini onaylayın.
• Görev başına token. Yeni, daha büyük bir temel model, aynı token başına oranda bile bir görevin kaç token gerektirdiğini değiştirir. Gerçek istemlerinizi ölçün.
• Çaba eşlemesi. Cursor belgeleri, çaba seviyelerinin Grok 4.6'dakinden daha ayrık olduğunu belirtiyor, bu nedenle medium ayarlı bir rota farklı davranabilir.

Değişmeyen her şey için Grok 4.6 API rehberimiz hala geçerlidir. İki not: https://us.api.x.ai/v1 %10 ek ücretle çıkarım işlemini ABD'de tutar ve Grok 4.7 Fast (2x fiyat) yalnızca Cursor ve Grok Build'de bulunur, halka açık API'de değildir.

Grok 4.7 API'sini Apidog'da Test Edin

Kaydedilmiş, tekrarlanabilir bir istek, çaba düzeylerini karşılaştırırken veya bir yükseltmeyi kontrol ederken shell geçmişinizdeki bir curl komutundan daha iyidir.

1. Apidog'da base_url'i https://api.x.ai/v1 olarak ayarlanmış ve XAI_API_KEY'i gizli bir değişken olarak saklanmış bir ortam oluşturun. İhtiyaç duymanız halinde ABD uç noktası için ikinci bir ortam ekleyin.
2. İsteği kaydedin: POST {{base_url}}/responses, Authorization: Bearer {{XAI_API_KEY}} başlığı ve gerçek isteminiz gövdede olacak şekilde.
3. Onaylar ekleyin: durum 200, model grok-4.7'ye eşit, usage mevcut ve output bir message öğesi içeriyor. Bunlar, uygulamanızdan önce yanlış bir anahtarı, yanlış bir model kimliğini veya değişmiş bir yanıt şeklini yakalar.
4. Her çaba düzeyi için klonlayın (low, medium, high, xhigh) ve dördünü tek bir test senaryosu olarak çalıştırın. İsteminiz için yanıt süresini ve token kullanımını yan yana alırsınız, bir kıyaslama sonucunu değil.
5. Yanıt şekli kararlı hale geldiğinde uç noktayı sahteleyin, böylece ön uç çalışmaları kredi harcamadan devam edebilir.

Bir sonraki model piyasaya sürüldüğünde, bir değişkeni değiştirin ve yeniden çalıştırın. Kurulum için Apidog'u indirin.

Sıkça Sorulan Sorular

Grok 4.7 model kimliği nedir? grok-4.7. Ortak platformlarda spacexai/grok-4.7 (Vercel AI Gateway) ve x-ai/grok-4.7 (OpenRouter) olarak geçer.

Grok 4.7 API'si ne kadara mal olur? 200.000 token altındaki istemler için milyon giriş tokeni başına 2 dolar, önbelleğe alınmış için 0,50 dolar ve çıkış için 6 dolar; 200.000 ve üzeri tokenler için bu fiyatlar iki katıdır. 4.7 için toplu indirim yoktur.

Akıl yürütmeyi kapatabilir miyim? Hayır. En hızlı ve en ucuz yanıtlar için low çabayı kullanın.

Ücretsiz Grok 4.7 API'si var mı? xAI'nin API'si ön ödemeli kredilerle çalışır. Grok 4.7'yi ücretsiz nasıl kullanacağınıza dair rehberimiz, mevcut olan ücretsiz yolları kapsar.

Grok 4.7, GPT-6 Sol ve Claude Opus 5.5 ile nasıl karşılaştırılır? Üçü arasında en düşük çıkış fiyatına sahiptir ve her iki sağlayıcının da bildirdiği kodlama kıyaslamalarında Opus 5.5'in gerisindedir. Üçlü karşılaştırma rakamları içermektedir.

Kaydedilmiş bir istekle başlayın

Yukarıdaki curl isteğini gönderin, ardından iddialar ve bir çaba düzeyi senaryosu ile Apidog'a kaydedin. Trafiği taşımadan önce kendi istemleriniz üzerinde görev başına bir temel maliyet elde edersiniz. Varsayılan bir çaba düzeyi seçmek için, sonraki Grok 4.7 kıyaslamaları dökümünü okuyun.