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 en iyi arama sonuçlarında API'yi baştan sona nasıl çağıracağınızı anlatan hiçbir şey yok. Bu rehber bu eksikliği gideriyor.

Sonunda bir API anahtarına, curl, Python ve JavaScript'te çalışan bir isteğe, akışlı çıktıya ve Grok 4.6 uç noktalarını üretime sokmadan önce test etmek için tekrarlanabilir bir kuruluma sahip olacaksınız. Terminal pencereleri arasında geçiş yapmak yerine bu istekleri görsel olarak oluşturmak ve hata ayıklamak isterseniz, Apidog tüm akışı yönetir; takip etmek için ücretsiz indirin.

TL;DR (Çok Uzun; Okumadım)

• console.x.ai adresinden bir API anahtarı alın, bunu XAI_API_KEY olarak ayarlayın ve grok-4-6 modeliyle https://api.x.ai/v1/chat/completions adresini çağırın.
• API, OpenAI ile uyumludur, bu nedenle resmi OpenAI SDK'ları temel URL'yi değiştirerek çalışır, öğrenilecek yeni bir istemci kütüphanesi yoktur.
• Grok 4.6 size 500.000 jetonluk bir 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. Daha hızlı varyantın maliyeti iki katıdır.
• Yerel API'ye ek olarak Grok 4.6, OpenRouter, Vercel, Cloudflare, Cursor ve Grok Build aracılığıyla da mevcuttur.
• İstekleri test edin, akış yanıtlarını inceleyin ve CI için Grok uç noktalarını Apidog ile taklit edin.

Neyle Çalışıyorsunuz?

Herhangi bir kod yazmadan önce, entegrasyon kararları için önemli olan teknik özellikler tablosu aşağıdadır:

Grok 4.5'e göre başlıca iyileştirmeler ajanik özelliktedir: xAI, modelin uzun süreçlerde kendi çalışmalarını daha sık kontrol ettiğini ve etkileşimli ve görsel projelerde daha güçlü ilk geçişler ürettiğini bildirmektedir. Benchmark'larda DeepSWE v1.1'de %54'ten %65,9'a ve APEX-Agents'ta %47,1'den %57,5'e yükseldi. Eğer Grok 4.5 API'sine göre geliştirme yaptıysanız, entegrasyon yüzeyi değişmemiştir; temel için Grok 4.5 API rehberimize 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 bir xAI hesabı oluşturun.
2. Kenar çubuğundan API Anahtarları'nı açın ve API anahtarı Oluştur'a tıklayın.
3. Anahtarı ortamına göre adlandırın (grok-dev, grok-prod); daha sonra anahtarları döndürürken kendinize teşekkür edeceksiniz.
4. Anahtarı hemen kopyalayın. xAI bunu yalnızca bir kez gösterir.

Koda yapıştırmak yerine bir ortam değişkeni olarak saklayın:

export XAI_API_KEY="your-key-here"

İlk günden itibaren edinilmesi gereken bir alışkanlık: geliştirme ve üretim için ayrı anahtarlar kullanın ve hiçbir anahtarı sürüm kontrolüne kaydetmeyin. Eğer bir anahtar sızarsa, konsolda iptal edin ve yeni bir tane oluşturun.

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

xAI API'si, OpenAI sohbet tamamlama formatını takip eder. İşte minimum istek:

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ıt, asistan mesajını içeren bir choices dizisi ve giriş ile çıkış jetonlarını sayan bir usage nesnesi döndürür. Bu usage bloğu sizin faturalandırma ölçütünüzdür, baştan itibaren kaydedin.

İpucu: Model kimlikleri bazen yerel API ile satıcılar (örneğin, OpenRouter'da x-ai/grok-4.6 olarak listelenir) arasında farklılık gösterebilir. Eğer bir 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 ile uyumlu olduğundan, resmi OpenAI SDK'ları iki satır değişikliğiyle (temel URL ve anahtar) çalışır.

Python:

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)

JavaScript / TypeScript:

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);

Bu uyumluluk, her iki yönde de geçişin ucuz olduğu anlamına gelir. Eğer zaten GPT-5.6 API'sini kullanıyorsanız, tek bir yapılandırma bayrağının arkasında Grok 4.6'yı buna karşı A/B testi yapabilirsiniz.

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

Kullanıcıya yönelik herhangi bir şey için akış kullanın. Grok 4.6, uzun çok adımlı çıktılar için ayarlanmıştır ve kullanıcıları 2.000 jetonluk bir yanıt için dönen bir imlece baktırmak kötü bir alışveriştir.

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. Hata ayıklarken bir terminalde incelemek zordur, her parça ayrı bir data: satırıdır ve hatalı işleme düşen jetonlar veya takılı kalan kullanıcı arayüzleri olarak ortaya çıkar. Apidog, SSE akışlarını yanıt panelinde gerçek zamanlı olarak işler, bu da bir takılmanın modelin düşünmesinden mi yoksa istemcinizin tamponlamasından mı kaynaklandığını açıkça gösterir.

Adım 5: 500 bin bağlamı dikkatlice kullanın

500.000 jetonluk bir pencere, orta büyüklükte bir kod tabanının tamamını veya yüzlerce sayfalık belgeyi sığdırabilir. Her şeyi ona atmadan önce iki uyarı:

• Maliyet, girişle orantılı olarak artar. Milyon giriş jetonu başına 2 dolardan, tam 500 bin jetonluk bir prompt, model bir kelime bile yazmadan önce istek başına yaklaşık 1 dolara mal olur. Aynı metin üzerinde tekrarlanan sorgular için, her şeyi yeniden göndermek yerine agresif bir şekilde önbelleğe alın veya seçici olarak geri getirin.
• Konum önemlidir. Her uzun bağlam modelinde olduğu gibi, geri alma kalitesi istemin başlangıcına ve sonuna yakın en güçlüdür. Talimatları üste, soruyu alta koyun; referans materyalini araya yerleştirin.

Hızlı varyant (2 kat fiyat), etkileşimli kodlama asistanları gibi gecikmeye duyarlı yollar için değerlidir. Toplu işler, gece analizi, toplu sınıflandırma için standart katman bariz bir seçimdir. GPT-5.6 ve Claude ile tam fiyatlandırma matematiği ve karşılaştırmaları, yapısal olarak 4.6 için hala geçerli olan Grok 4.5 fiyatlandırma dökümümüzde bulunmaktadır.

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

Çalışan bir curl komutu bir entegrasyon değildir. Grok 4.6 üretime girmeden önce, isteklerin versiyonlandığı, ortamların ayrıldığı ve hataların tekrarlanabilir olduğu bir yere ihtiyacınız vardır. İşte Apidog'un iş akışındaki yerini aldığı nokta:

1. Bir proje oluşturun ve base_url = https://api.x.ai/v1 ile XAI_API_KEY'nizi bir ortam değişkeni olarak içeren bir ortam ekleyin. Geliştirme ve üretim anahtarları ayrı kalır.
2. Sohbet tamamlama isteğini bir kez, ortamdan devralınan yetkilendirme ile oluşturun. Artık her ekip üyesi aynı uç noktayı aynı şekilde kullanır.
3. Akışı görsel olarak inceleyin. Apidog, SSE parçalarını geldikçe gösterir, böylece jeton jeton çıktıyı izleyebilir ve takılmaları veya kesilmeleri anında fark edebilirsiniz.
4. Doğrulama ekleyin. choices[0].message.content'in boş olmadığını, usage.total_tokens'ın bütçe dahilinde kaldığını ve yanıt süresinin SLA'nızı karşıladığını doğrulayın, ardından bunları CI'da otomatik test senaryoları olarak çalıştırın.
5. Uç noktayı taklit edin (mock). Apidog'un akıllı taklidi, gerçekçi Grok biçimli yanıtlar döndürür, böylece ön uç ve ajan kodları, siz istemler üzerinde çalışırken, jeton yakmadan kararlı bir sahteye karşı geliştirme yapabilir.

Bu son nokta, kulağa geldiğinden daha önemlidir. Görev başına modeli düzinelerce kez çağıran ajan döngüleri, canlı API'ye karşı test edilmesi pahalı hale gelir. Başarılı senaryoyu taklit etmek ve gerçek şeyi ayrı ayrı test etmek, CI'ı hızlı ve faturanızı makul seviyede tutar.

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

Sıkça Sorulan Sorular

Grok 4.6 API'si OpenAI ile uyumlu mu? Evet. Sohbet tamamlama uç noktası aynı istek şeklini kabul eder ve resmi OpenAI SDK'ları base_url'yi https://api.x.ai/v1 adresine işaret ederek çalışır.

Grok 4.6 API'si ne kadar? Milyon giriş jetonu başına 2 dolar ve milyon çıkış jetonu başına 6 dolar. Daha hızlı varyantın maliyeti iki katıdır. 500 binlik bağlam için ayrı bir ücret yoktur, sadece gerçekten gönderdiğiniz 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 yeterli. İstek formatı, 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 aracılığıyla, her biri kendi faturalandırma sistemine sahiptir. Yerel API, genellikle hacimli kullanımlarda en ucuz yoldur.