Grok 4.6 API Nasıl Kullanılır

xAI, Grok 4.6'yı 12 Ağustos 2026'da piyasaya sürdü ve hedefi doğrudan geliştiriciler: uzun süreli ajanlar ve çok adımlı kodlama işleri için öncü düzeyde bir model, milyon giriş jetonu başına 2 dolar ve milyon çıkış jetonu başına 6 dolar fiyatla. Resmi belgeler referans materyali kapsıyor, ancak API'yi baştan sona çağırmak için uygulanabilir bir akışa ihtiyacınız var. Bu rehber, ilk isteğinizden üretim testlerine kadar süreci adım adım gösterir.

Apidog'u bugün deneyin

Bu yazının sonunda bir API anahtarına, curl, Python ve JavaScript ile çalışan isteklere, akışlı çıktıya ve Grok 4.6 uç noktalarını üretime almadan önce test edebileceğiniz tekrarlanabilir bir kuruluma sahip olacaksınız. İstekleri terminal yerine görsel olarak oluşturmak ve hata ayıklamak isterseniz Apidog ile tüm akışı yönetebilirsiniz.

TL;DR

• console.x.ai üzerinden API anahtarı alın, bunu XAI_API_KEY olarak ayarlayın ve grok-4-6 modeliyle https://api.x.ai/v1/chat/completions uç noktasını çağırın.
• API, OpenAI ile uyumludur. Resmi OpenAI SDK'larını temel URL'yi değiştirerek kullanabilirsiniz.
• Grok 4.6, 500.000 jetonluk bağlam penceresi ve 1 Şubat 2026'ya kadar güncel bilgi sunar.
• Fiyatlandırma: milyon giriş jetonu başına 2 dolar, milyon çıkış jetonu başına 6 dolar. Hızlı varyant iki kat fiyatlıdır.
• Yerel API'ye ek olarak Grok 4.6; OpenRouter, Vercel, Cloudflare, Cursor ve Grok Build üzerinden de kullanılabilir.
• İstekleri test etmek, SSE akışlarını incelemek ve CI için uç noktaları taklit etmek için Apidog kullanın.

Neyle Çalışıyorsunuz?

Kod yazmadan önce entegrasyon kararlarını etkileyen temel özellikleri netleştirin:

Özellik	Grok 4.6
Yayın tarihi	12 Ağustos 2026
Bağlam penceresi	500.000 jeton
Bilgi kesme tarihi	1 Şubat 2026
Giriş fiyatı	1M jeton başına 2 $
Çıkış fiyatı	1M jeton başına 6 $
Hızlı varyant	2 kat fiyat
API tarzı	OpenAI uyumlu REST
Erişilebilirlik	xAI API, OpenRouter, Vercel, Cloudflare, Cursor, Grok Build

Grok 4.5'e göre başlıca iyileştirmeler ajanik yeteneklerdedir: xAI, modelin uzun süreçlerde kendi çalışmalarını daha sık kontrol ettiğini ve etkileşimli, görsel projelerde daha güçlü ilk geçişler ürettiğini bildirmektedir. Benchmark sonuçları DeepSWE v1.1'de %54ten %65,9a, APEX-Agents'ta ise %47,1den %57,5e yükselmiştir.

Grok 4.5 API'sine göre geliştirme yaptıysanız entegrasyon yüzeyi değişmez. Temel kurulum için Grok 4.5 API rehberine bakın, ardından model adını değiştirin.

Adım 1: API Anahtarınızı Alın

1. console.x.ai adresine gidin ve oturum açın veya xAI hesabı oluşturun.
2. Kenar çubuğundan API Anahtarları bölümünü açın.
3. API anahtarı oluştur seçeneğine tıklayın.
4. Anahtarı ortama göre adlandırın: grok-dev, grok-staging veya grok-prod.
5. Anahtarı hemen kopyalayın. xAI anahtarı yalnızca bir kez gösterir.

Anahtarı kaynak koduna yapıştırmak yerine ortam değişkeni olarak saklayın:

export XAI_API_KEY="your-key-here"

Geliştirme ve üretim ortamları için ayrı anahtarlar kullanın. Anahtarı Git'e, .env dosyasının takip edilen bir sürümüne veya CI loglarına yazmayın. Bir anahtar sızarsa konsoldan iptal edin ve yenisini oluşturun.

Adım 2: curl ile İlk İsteğiniz

xAI API'si OpenAI sohbet tamamlama biçimini kullanır. Aşağıdaki istek, Grok 4.6'ya minimum bir çağrı yapar:

curl https://api.x.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-6",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain idempotency in REST APIs in two sentences."}
    ]
  }'

Başarılı bir yanıtta şunları kontrol edin:

• choices: Modelin ürettiği asistan mesajını içerir.
• choices[0].message.content: Kullanıcıya göstereceğiniz metindir.
• usage: Giriş ve çıkış jetonlarını içerir; maliyet ve kota takibi için kaydedin.

Model kimlikleri yerel API ile farklı sağlayıcılar arasında değişebilir. Örneğin OpenRouter'da model x-ai/grok-4.6 olarak listelenebilir. model not found hatası alırsanız, anahtarınızın erişebildiği modelleri listeleyin:

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer $XAI_API_KEY"

Adım 3: Python ve JavaScript

API OpenAI uyumlu olduğu için resmi OpenAI SDK'larını kullanabilirsiniz. Yalnızca API anahtarını ve temel URL'yi değiştirmeniz gerekir.

Python

Önce SDK'yı kurun:

pip install openai

Ardından istemciyi oluşturun:

from openai import OpenAI
import os

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

response = client.chat.completions.create(
    model="grok-4-6",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Write a Python function that validates an email address."},
    ],
)

print(response.choices[0].message.content)
print(response.usage)

Üretimde response.usage değerini yapılandırılmış log olarak kaydedin. Bu sayede istek başına jeton tüketimini ve maliyeti izleyebilirsiniz.

JavaScript / TypeScript

SDK'yı kurun:

npm install openai

İsteği gönderin:

import OpenAI from "openai";

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

const response = await client.chat.completions.create({
  model: "grok-4-6",
  messages: [
    { role: "system", content: "You are a concise technical assistant." },
    { role: "user", content: "Write a TypeScript type guard for a User object." },
  ],
});

console.log(response.choices[0].message.content);
console.log(response.usage);

Bu uyumluluk, model sağlayıcıları arasında geçiş maliyetini düşürür. Halihazırda GPT-5.6 API'sini kullanıyorsanız, temel URL ve model adını bir yapılandırma bayrağının arkasına alarak Grok 4.6 ile A/B testi yapabilirsiniz.

Adım 4: Akış Yanıtları

Kullanıcıya yönelik arayüzlerde akış kullanın. Özellikle uzun ve çok adımlı çıktılarda, kullanıcıların tam yanıt gelene kadar beklemesi yerine üretimi parça parça göstermelisiniz.

Python ile akış örneği:

stream = client.chat.completions.create(
    model="grok-4-6",
    messages=[
        {
            "role": "user",
            "content": "Refactor this function and explain each change: ..."
        }
    ],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Akış yanıtları sunucu tarafından gönderilen olaylar (SSE) olarak gelir. Uygulamanızda aşağıdaki durumları kontrol edin:

• İstekte stream: true gönderildiği.
• İstemcinin gelen parçaları tamponlamadan kullanıcı arayüzüne aktardığı.
• Proxy veya CDN katmanının SSE yanıtını kesmediği.
• Bağlantı kapanırsa istemcinin hata durumunu kullanıcıya bildirdiği.

SSE akışlarını terminalde incelemek zor olabilir; her parça ayrı bir data: satırı olarak gelir. Apidog, SSE parçalarını yanıt panelinde gerçek zamanlı göstererek sorunun model gecikmesinden mi yoksa istemci tamponlamasından mı kaynaklandığını ayırt etmenize yardımcı olur.

Adım 5: 500 Binlik Bağlamı Dikkatli Kullanın

500.000 jetonluk pencere, orta büyüklükte bir kod tabanını veya yüzlerce sayfalık belgeyi tek isteğe sığdırabilir. Ancak bağlam penceresini tamamen doldurmak her zaman doğru strateji değildir.

Maliyeti hesaplayın

Giriş fiyatı milyon jeton başına 2 dolardır. Tam 500.000 jetonluk bir istem yaklaşık 1 dolar giriş maliyeti oluşturur; model henüz çıktı üretmeden bu maliyet oluşur.

Tekrarlayan sorgularda:

• Aynı belgeleri her istekte yeniden göndermeyin.
• Sık kullanılan bağlamı önbelleğe alın.
• Yalnızca ilgili dosyaları veya belge bölümlerini geri getirin.
• Ajan döngülerinde her adım için bağlam boyutunu ölçün.

Bilgiyi doğru sırada yerleştirin

Uzun bağlamlı modellerde konum önemlidir. Geri alma kalitesi genellikle istemin başına ve sonuna yakın bölümlerde daha güçlüdür.

Pratik istem düzeni:

1. Sistem talimatları
2. Görev için gerekli kurallar
3. Referans materyali / kod / belgeler
4. Kullanıcının asıl sorusu
5. Beklenen çıktı biçimi

Hızlı varyant, etkileşimli kodlama asistanları gibi gecikmeye duyarlı akışlar için uygundur. Toplu işler, gece analizleri ve toplu sınıflandırma için standart katman daha mantıklı olabilir. GPT-5.6 ve Claude ile fiyatlandırma karşılaştırmaları için Grok 4.5 fiyatlandırma dökümüne bakabilirsiniz.

Entegrasyonu Apidog ile Düzgün Şekilde Test Edin

Çalışan bir curl komutu tek başına üretim entegrasyonu değildir. Grok 4.6'yı üretime almadan önce istekleri sürümlendirebileceğiniz, ortamları ayırabileceğiniz ve hataları tekrarlayabileceğiniz bir test akışı kurun.

Apidog ile önerilen kurulum:

1. Bir proje oluşturun ve ortam tanımlayın:
   • base_url = https://api.x.ai/v1
   • XAI_API_KEY = ...
2. Geliştirme ve üretim için ayrı ortamlar oluşturun. Böylece anahtarlar ve hedef URL'ler birbirine karışmaz.
3. Sohbet tamamlama isteğini bir kez yapılandırın ve yetkilendirme başlığını ortam değişkeninden alın.
4. SSE akışını görsel olarak inceleyin. Parçaların ne zaman geldiğini, kesilip kesilmediğini ve istemcinin doğru işleyip işlemediğini kontrol edin.
5. Otomatik doğrulamalar ekleyin:
   • choices[0].message.content boş olmamalı.
   • usage.total_tokens belirlediğiniz bütçeyi aşmamalı.
   • Yanıt süresi SLA hedefinizi karşılamalı.
6. Bu kontrolleri CI içinde otomatik test senaryosu olarak çalıştırın.
7. Uç noktayı taklit edin. Gerçekçi Grok biçimli sahte yanıtlarla ön uç ve ajan kodunu, canlı API'ye jeton harcamadan geliştirin.

Bu yaklaşım özellikle ajan döngülerinde önemlidir. Bir görevi tamamlamak için modeli onlarca kez çağıran akışları sürekli canlı API üzerinde test etmek maliyetli olabilir. Başarılı ve hata senaryolarını taklit edip canlı API testlerini ayrı tutmak, CI süresini ve maliyeti kontrol altında tutar.

Sık Görülen Hatalar ve Hızlı Düzeltmeler

Hata	Olası neden	Çözüm
401 Unauthorized	Eksik veya yanlış biçimlendirilmiş Authorization başlığı	Bearer önekini ve kullandığınız kabukta ortam değişkeninin ayarlı olduğunu kontrol edin.
404 model not found	Sağlayıcınız için yanlış model kimliği	/v1/models uç noktasını çağırın. Satıcılar farklı model kimlikleri kullanabilir; örneğin OpenRouter'da x-ai/grok-4.6.
429 Too Many Requests	Oran sınırlaması veya kota tükenmesi	Üstel geri çekilme uygulayın ve console.x.ai üzerinden kullanımı kontrol edin.
Kırpılmış çıktı	Uzun ajanik yanıt için max_tokens değeri düşük	Sınırı yükseltin. Grok 4.6, çok adımlı görevlerde ayrıntılı çıktı üretebilir.
Takılmış akış	İstemci tamponlaması veya proxy'nin SSE'yi kaldırması	stream: true değerini doğrulayın, proxy arabelleklemesini kapatın ve ham akışı Apidog ile test edin.

Sıkça Sorulan Sorular

Grok 4.6 API'si OpenAI ile uyumlu mu?

Evet. Sohbet tamamlama uç noktası aynı istek biçimini kabul eder. Resmi OpenAI SDK'ları, base_url değerini https://api.x.ai/v1 olarak ayarladığınızda çalışır.

Grok 4.6 API'si ne kadar?

Milyon giriş jetonu başına 2 dolar, milyon çıkış jetonu başına 6 dolardır. Daha hızlı varyant iki kat fiyatlıdır. 500 binlik bağlam için ayrı ücret yoktur; yalnızca gönderdiğiniz ve üretilen jetonlar için ödeme yaparsınız.

Grok 4.5 kullanıyorsam yeni bir entegrasyona ihtiyacım var mı?

Hayır. Model adını değiştirmeniz yeterlidir. İstek biçimi, yetkilendirme ve uç noktalar Grok 4.5'ten bu yana değişmemiştir.

xAI hesabı olmadan Grok 4.6'yı kullanabilir miyim?

Evet. OpenRouter, Vercel AI Gateway veya Cloudflare üzerinden kullanabilirsiniz; her sağlayıcının kendi faturalandırma sistemi vardır. Yerel API, hacimli kullanımlarda genellikle en ucuz yol olabilir.