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

xAI, Grok 4.3'ü aşamalı olarak kullanıma sundu: beta 17 Nisan 2026'da, API erişimi 30 Nisan'da ve tam genel kullanıma sunulması 6 Mayıs'ta gerçekleşti. Sunum doğrudan: 1.000.000 jetonluk bağlam penceresi, Grok serisinde ilk kez yerel video girişi, her zaman açık muhakeme ve Grok 4.20'ye kıyasla yaklaşık %40 fiyat indirimi. Sekiz eski Grok modeli 15 Mayıs'ta kullanımdan kaldırılacak, bu nedenle grok-3 veya grok-4 serilerinde çalışan herkesin bu hafta bir geçiş planlaması yapması gerekiyor.

Bu kılavuz, Grok 4.3'ü kodunuzdan nasıl çağıracağınızı kapsar: uç nokta yapısı, kimlik doğrulama, OpenAI uyumlu temel URL, muhakeme çabası parametresi, video girişi, fonksiyon çağırma ve Apidog'da çalışan bir test kurulumu.

Aynı sürümün ses tarafı için Grok Sesini Ücretsiz Nasıl Kullanılır konusuna bakın. OpenAI'nin amiral gemisi ses modeline karşı birebir kıyaslama için Grok Sesi vs GPT-Realtime konusuna bakın.

TL;DR

• Grok 4.3, 6 Mayıs 2026'da genel kullanıma sunuldu (GA). Sekiz eski model 15 Mayıs 2026'da kullanımdan kaldırılıyor.
• Fiyatlandırma: 1M giriş jetonu başına 1.25 $, 1M çıkış jetonu başına 2.50 $, önbelleğe alınmış giriş 1M başına 0.20 $. Grok 4.20'ye kıyasla yaklaşık %40 indirim.
• 1M jetonluk bağlam penceresi. Yerel video girişi. Her zaman açık muhakeme.
• Muhakeme çabası: low / medium / high. Varsayılan medium.
• Uç nokta: https://api.x.ai/v1/chat/completions (OpenAI uyumlu temel URL).
• İşlem hacmi: Standart katmanlarda ~159 jeton/saniye.
• Zeka Endeksi 53 (Yapay Analiz), dünya genelinde 146 model arasında 10. sırada.
• İsteği betiklemek, muhakeme yapılandırmalarını değişken olarak tutmak ve hem Grok hem de OpenAI uyumluluk modlarında tekrar oynatmak için Apidog kullanın.

Grok 4.3'te neler değişti

Çoğu ekip için etki sırasına göre başlıca yükseltmeler:

• %40 fiyat düşüşü. Giriş, Grok 4.20'ye kıyasla %37.5; çıkış ise %58.3 oranında azaldı. Önbelleğe alınmış giriş ücreti artık 1M başına 0.20 $, bu da uzun ve stabil sistem komutlarını çok daha ucuz hale getiren agresif bir indirim.
• 1M jetonluk bağlam. Grok 4.20'deki 256k'dan yükseltildi. Orta büyüklükte bir kod tabanını, tam bir kazanç çağrısını veya eksiksiz bir yasal sözleşmeyi tek bir isteme sığdırmak için yeterli.
• Yerel video girişi. Grok serisinde ilk kez. Bir video URL'si geçirin ve model kareler üzerinde yerel olarak muhakeme yapsın.
• Her zaman açık muhakeme. Grok 4.3, her istekte temel bir muhakeme adımıyla birlikte gelir. reasoning_effort parametresi derinliği ölçeklendirir, ancak model hiçbir zaman low seviyesinden daha az muhakeme yapmaz.
• Büyük ajanssal kazanç. Grok 4.20'ye karşı GDPval-AA üzerinde +300 Elo puanı. Araç gönderme ve çok adımlı iş akışları belirgin şekilde daha iyi çalışır.

53'lük (Yapay Analiz) Zeka Endeksi, Grok 4.3'ü fiyat kademesi için ortalama 35'in üzerine ve takip edilen 146 model arasında onuncu sıraya koyar.

Önkoşullar

İlk istekten önce dört şeyi hazırlayın:

• console.x.ai adresinde bir xAI Konsol hesabı. Grok Voice ile aynı oturum açma akışı.
• Bir API anahtarına sahip faturalandırılabilir bir katman. Üretim için projeye özel anahtarlar önerilir.
• OpenAI SDK (Grok 4.3 OpenAI uyumludur) veya xAI SDK. Her ikisi de çalışır.
• Terminalinizi spamlemeden istekleri tekrar oynatabilen bir API istemcisi.

Anahtarı bir kez dışa aktarın:

export XAI_API_KEY="xai-..."

Uç nokta ve kimlik doğrulama

Grok 4.3, xAI'nin temel URL'si ile OpenAI uyumlu Chat Completions yüzeyinde gönderilir.

POST https://api.x.ai/v1/chat/completions

Kimlik doğrulama bir taşıyıcı jetonudur. Başlıklar standarttır:

Authorization: Bearer $XAI_API_KEY
Content-Type: application/json

OpenAI uyumluluğu, OpenAI Python veya Node SDK'yı bırakıp base_url'yi değiştirebileceğiniz anlamına gelir. Bu, gpt-4 veya gpt-5'ten geçiş yapan çoğu ekip için en az dirençli yoldur.

from openai import OpenAI

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

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[
        {"role": "user", "content": "Summarize the trade-offs of GraphQL vs REST in three bullets."}
    ],
    reasoning_effort="medium",
)

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

xAI SDK'yı tercih ediyorsanız, çağrı şekli aynıdır; tek değişiklik içe aktarmadır.

İstek parametreleri

Grok 4.3 için tam parametre haritası:

Çalışan bir curl isteği:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "messages": [
      {"role": "system", "content": "You are a senior backend engineer."},
      {"role": "user", "content": "Review this query plan and flag the bottleneck."}
    ],
    "reasoning_effort": "high"
  }'

Yanıt, standart OpenAI şeklini taşır: choices[].message.content, ayrıca prompt_tokens, completion_tokens, reasoning_tokens ve total_tokens ayrı ayrı belirtildiği bir usage nesnesi.

Muhakeme çabası

Üç seviye, somut rehberlikle:

• low. Sınıflandırma, özetleme, kural çıkarma, basit S&C için kullanın. Gecikme kısadır, çıktı doğrudan.
• medium. Varsayılan. Müşteri hizmetleri, fonksiyon çağırma, veri analizi, tek adımlı araç kullanımı için kullanın. Muhakeme derinliği çoğu üretim trafiği için yeterlidir.
• high. Çok adımlı ajanlar, uzun zincirli kod incelemesi, karmaşık matematik ve modelin yanıtlamadan önce planlama yapması gereken görevler için kullanın.

Her zaman açık muhakeme, low seviyesinde bile bir miktar düşünme olduğu anlamına gelir; Grok 4.20'ye göre doğruluk kazancını sağlayan budur. Muhakemeden tamamen kaçınarak tasarruf etmeyi beklemeyin; bu, yerleşiktir.

Fonksiyon çağırma

Standart OpenAI şekli doğrudan çalışır. Araçları bildirin, model yardımcı mesajda bir tool_calls dizisi çıkarır, siz yürütürsünüz, bir tool rolü mesajıyla yanıt verirsiniz:

tools = [{
    "type": "function",
    "function": {
        "name": "lookup_user",
        "description": "Look up a user by ID.",
        "parameters": {
            "type": "object",
            "properties": {"user_id": {"type": "string"}},
            "required": ["user_id"],
        },
    },
}]

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{"role": "user", "content": "Find user u_42 and tell me their last login."}],
    tools=tools,
    reasoning_effort="medium",
)

tool_calls = response.choices[0].message.tool_calls

GDPval-AA'daki 300 Elo kazancı pratikte burada kendini gösterir; Grok 4.3 daha iyi araçlar seçer, daha az gereksiz çağrı yapar ve bir araç hatasından dönmeden kurtulur. Araç akışlarını test ediyorsanız, Apidog'daki MCP sunucu testi dahili olarak kullandığımız tekrar oynatma kurulumunu kapsar.

Video girişi

Grok 4.3, yerel video girişi olan ilk Grok modelidir. Bir içerik bloğuna bir video URL'si geçirin:

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe what happens in this clip and flag any anomalies."},
            {"type": "video_url", "video_url": {"url": "https://example.com/clip.mp4"}},
        ],
    }],
)

Video jetonları giriş ölçerine sayılır. Uzun klipler bağlamı hızlı tüketir; maliyet önemliyse göndermeden önce örneklemeyi azaltın veya kırpın. Model kareler üzerinde yerel olarak muhakeme yapar, bu nedenle ana kareleri manuel olarak çıkarmanıza gerek yoktur.

1M jetonluk bağlam

1M bağlam penceresi, bir kıyaslama kupası değil, gerçek bir üretim aracıdır. Yaygın kullanım desenleri:

• Tüm kod tabanının kod incelemesi. Farkı, dokunulan tüm dosyaları ve lint çıktısını birleştirin. Grok'tan incelemesini isteyin.
• Uzun biçimli belge S&C. 200 sayfalık bir sözleşmeyi bırakın ve hedefli sorular sorun.
• Konuşma hafızası. Kişiselleştirme için bir aylık ajan konuşmalarının tamamını bağlamda tutun.

1M başına 0.20 $ olan önbelleğe alınmış giriş, bunu uygun fiyatlı hale getirir. Stabil tuttuğunuz 400 bin jetonluk bir sistem istemi, her önbelleğe alınmış çağrı başına taze 0.50 $ yerine 0.08 $ yakar.

Eski Grok modellerinden geçiş

Sekiz eski Grok modeli 15 Mayıs 2026, 12:00 PM PT'de kullanımdan kaldırılacak. Eğer bunlardan herhangi birini kullanıyorsanız, kesintiden önce model dizesini grok-4.3 olarak değiştirin. İstek şekli değişmediği için çoğu çağrı başka bir değişiklik olmadan çalışır.

Dikkat edilmesi gereken iki şey:

• Muhakeme çabası. Bazı eski modeller reasoning_effort'ı kabul etmiyordu. Grok 4.3 her zaman muhakeme yapar; eğer önceki kodunuz hızlı, muhakeme yapmayan bir yola dayanıyorsa, gecikme artışını kabul edin veya low'da kalın.
• Çıktı biçimlendirme. Grok 4.3, varsayılan olarak Grok 4.20'den daha yapılandırılmıştır. Ağır regex sonrası işlem kullandıysanız, değiştirmeden önce tekrar test edin.

OpenAI hattındaki tam fiyat karşılaştırması için GPT-5.5 fiyatlandırması'na bakın; birebir muhakeme modelleri için GPT-5.5 API'sini Nasıl Kullanılır konusuna bakın.

Apidog'da test etme

Grok 4.3'ü kendi kullanım durumunuza karşı doğrulamanın en hızlı yolu:

1. XAI_API_KEY ve BASE_URL = https://api.x.ai/v1 ile bir Apidog ortamı oluşturun.
2. Üç varyant içeren bir istek koleksiyonu kaydedin: low, medium, high muhakeme. Aynı istem, farklı çaba.
3. Üçünü de çalıştırın. Yanıtı, gecikmeyi ve usage.reasoning_tokens sayısını yan yana karşılaştırın.
4. Grok 4.3'ü GPT-5.5 ile aynı girdide karşılaştırmak için OpenAI'nin temel URL'sine işaret eden dördüncü bir varyant ekleyin. Aynı SDK, farklı model ve temel URL.

Karşılaştırmayı çalıştırmak için Apidog'u indirin. Koleksiyon, sağlayıcıları değiştirdiğinizde sorunsuz bir şekilde taşınır, asıl mesele budur. Daha geniş API test stratejisi için Kalite Güvence mühendisleri için API test aracı konusuna bakın.

Hız limitleri

xAI Konsolundaki katman limitleri, Katman 1'de dakikada birkaç bin istekten kurumsal katmanlarda yüz binlerce isteğe kadar değişir. Somut sayılar değişir; konsol panosunu kontrol edin. xAI'nin reklamını yaptığı 159 jeton/saniye işlem hacmi, toplam değil, akış başına çıktı hızıdır; eşzamanlı istekler katman limitleri dahilinde doğrusal olarak ölçeklenir.

Hız limitlerine ulaşırsanız, API bir retry-after başlığı ile 429 döndürür. Standart üstel geri çekilme bunu halleder.

SSS

Grok 4.3, uçtan uca OpenAI uyumlu mu? Chat Completions için evet. OpenAI SDK'sını bırakın, base_url'yi değiştirin, model'i değiştirin. Fonksiyon çağırma, yapılandırılmış çıktı ve akış hepsi aynı şekilde çalışır.

Yanıtlar API'sini destekliyor mu? xAI yüzeyi bugün Chat Completions'tır. Yanıtlar API'si yalnızca OpenAI'ye özeldir.

Pratikteki gerçek bağlam limiti nedir? 1.000.000 jeton. Uzun girdiler, 1M başına 1.25 $ olsa bile gerçek para demektir; isteminiz stabilse agresif bir şekilde önbelleğe alın.

Her zaman açık muhakeme gecikmeyi nasıl etkiler? İlk jeton gecikmesi, muhakeme yapmayan modellere göre biraz daha yüksektir, ancak Grok 4.3 çıktı akışını ~159 jeton/saniye hızında yapar, bu nedenle uçtan uca yanıt süresi rekabetçidir. Doğruluk hassasiyeti olan iş yüklerinde bu dengelemeye değer.

Grok 4.3'ü Grok Voice ile kullanabilir miyim? Evet. Ses ajanı (grok-voice-think-fast-1.0) muhakeme yaparken kaputun altında Grok 4.3'ü çağırır. Ayrıca TTS ve STT primitifleri üzerine inşa ettiğiniz bir ses döngüsünden Grok 4.3'ü doğrudan çağırabilirsiniz.

Eski Grok 3 / Grok 4 çağrılarım 15 Mayıs'tan sonra ne olacak? 410 (model kullanımdan kaldırıldı) hatasıyla başarısız olacaklar. Kesintiden önce geçiş yapın.

Grok 4.3 görüntü girişini destekliyor mu? Evet, yeni video girişinin yanı sıra. Bir içerik bloğuna bir görüntü URL'si geçirin, OpenAI ile aynı şekilde.

Sonuç

Grok 4.3, xAI'nin şimdiye kadar yayınladığı en agresif fiyat-performans hamlesidir. %40 kesinti, 1M bağlam, her zaman açık muhakeme ve yerel video, çoğu ajan iş yükü için onu ciddi bir günlük sürücü haline getiriyor. OpenAI uyumluluğu, geçişin bir yeniden yazma değil, sadece temel URL değişikliği olduğu anlamına gelir.

En hızlı doğrulama yolu: Apidog'da üç muhakeme varyantı betikleyin, gerçek istemlerinizi bırakın, gecikmeyi ve muhakeme jetonlarını ölçün. 15 Mayıs'tan önce geçiş yapın.