Grok API Anahtarı Nasıl Alınır ve İlk İsteğiniz Nasıl Yapılır (Grok 4.6)

Grok API anahtarı, kodunuzun HTTPS üzerinden Grok modellerini çağırabilmesi için xAI'ın geliştirici konsolundan verdiği kimlik bilgisidir. Bu anahtarı bir kez oluşturur, her istekte bir Taşıyıcı (Bearer) jetonu olarak gönderirsiniz ve xAI kullandığınız jetonları ekibinizin ön ödemeli kredilerinden düşer. Eğer bu kavram sizin için yeniyse, API anahtarının ne olduğu temel bilgileri kapsar; bu rehber, anahtarın bugün çalışmasını isteyen geliştiriciler içindir.

Sıralama şöyledir: anahtarı console.x.ai adresinde oluşturun, curl ile bir ve Python ile bir istek yapın, ardından anahtarı Apidog'a taşıyarak güvenle saklayabilir, bir kabuk (shell) içine yapıştırmak zorunda kalmadan istek gönderebilir ve bu ilk isteği kaydedilmiş bir teste dönüştürebilirsiniz. Mevcut amiral gemisi model grok-4.6'dır ve aşağıdaki her örnek bu modeli kullanır.

düğme

Başlamadan önce ihtiyacınız olanlar

Bir xAI hesabı. console.x.ai adresinden kaydolun.

Hesapta krediler. Konsol ön ödemeli kredilerle çalışır ve resmi hızlı başlangıç kılavuzu, kaydolduktan hemen sonra kredi yüklemenizi söyler. Bakiyeniz sıfır olduğunda istekler reddedilir.
curl (macOS ve çoğu Linux dağıtımı ile birlikte gelir) ve pip kurulu Python 3.9 veya üstü.
İsteği depolamak, test etmek ve paylaşılabilir hale getirmek istiyorsanız Apidog. Ücretsiz plan 4 kullanıcıyı kapsar, bu küçük bir ekip için yeterlidir. 4. Adımdan önce Apidog'u indirin.

Adım 1: xAI konsolunda anahtarı oluşturun

Giriş yapın ve Faturalandırma'yı açın. API harcama yönetimi altında, kredi kartıyla (anında hesaba geçer) veya banka transferiyle (faturalandırma belgelerine göre iki ila üç iş günü) kredi satın alın.
API Anahtarları sayfasını açın. Hızlı başlangıç kılavuzu console.x.ai/team/default/api-keys adresine bağlar. team (ekip) bölümü önemlidir: anahtarlar bir ekibe aittir, kişisel girişinize değil.
API Anahtarı Oluştur'a tıklayın ve altı ay sonra tanıyacağınız bir ad verin. “apidog-local-dev”, “key1”'den daha iyidir.
Anahtar oluşturulur oluşturulmaz kopyalayın. Bunu tam değeri göreceğiniz tek zaman olarak kabul edin.
Koda kaydetmek yerine bir ortam değişkeni olarak saklayın:

export XAI_API_KEY="paste-your-key-here"

XAI_API_KEY, resmi belgelerin kullandığı değişken adıdır, bu nedenle xAI'ın kendi SDK'sı ve çoğu topluluk entegrasyonu ek bir yapılandırma gerektirmeden bunu kullanır.

Ortam başına bir anahtar iyi bir alışkanlıktır. Yerel geliştirme, CI ve üretim için ayrı anahtarlar, sızdırılan bir dizüstü bilgisayar anahtarının başka hiçbir şeye dokunmadan silinebileceği anlamına gelir.

Adım 2: curl ile ilk çağrınızı yapın

xAI'ın birincil metin uç noktası POST https://api.x.ai/v1/responses'dir. Anahtarı Authorization başlığında, JSON'u gövdede ve model kimliğini model alanında gönderin:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "instructions": "You are a senior backend engineer. Answer in three sentences.",
    "input": "My API returns 429 to a client that retries instantly. What should the client change?"
  }'

Başarılı bir yanıt, bir output dizisine sahip JSON'dur. Metin, `"type": "output_text"` ile output[].content[].text adresinde bulunur ve bir usage nesnesi input_tokens, output_tokens ve total_tokens'ı, ayrıca muhakeme ve önbelleğe alınmış jetonlar için dökümleri raporlar. Bu kullanım sayıları faturalandırıldığınız şeylerdir, bu yüzden ilk günden itibaren bunları kaydedin.

Bilinmesi gereken iki detay:

instructions sistem istemidir. Sohbet yapısını tercih ediyorsanız input'u {role, content} mesaj dizisi olarak da iletebilirsiniz.
Mevcut OpenAI tarzı kodunuz varsa, POST https://api.x.ai/v1/chat/completions aynı anahtar ve model kimliğiyle hala çalışır. xAI bunu bir eski uç nokta olarak etiketler ve yeni özellikleri önce Yanıtlar'a gönderir, bu nedenle yeni projelerinizi /v1/responses üzerinde başlatın.

Bu aynı uç noktada akış (streaming), araç çağrıları ve görüntü girişi için Grok 4.6 API'si nasıl kullanılır bölümüne bakın.

Adım 3: Python'dan aynı çağrı

xAI'ın REST API'si OpenAI SDK ile uyumludur, bu nedenle yeni bir istemci kütüphanesine ihtiyacınız yoktur. base_url'i xAI'a yönlendirin ve anahtarı ortamdan okuyun:

import os
from openai import OpenAI

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

response = client.responses.create(
    model="grok-4.6",
    instructions="You are a senior backend engineer. Answer in three sentences.",
    input="My API returns 429 to a client that retries instantly. What should the client change?",
)

print(response.output_text)
print(response.usage.input_tokens, response.usage.output_tokens)

SDK'yı pip install openai ile kurun. os.environ["XAI_API_KEY"]'yi okumak, değişken eksikse açık bir KeyError verir, bu da boş bir Taşıyıcı (Bearer) başlığı göndermek ve 401 hatasını ayıklamaktan daha iyidir.

xAI ayrıca gRPC taşıma ve Koleksiyonlar (Collections) ve Ses API'si (Voice API) gibi ek özelliklere sahip yerel bir Python SDK (xai-sdk) yayınlamaktadır. İlk çağrı için OpenAI istemcisi daha kısa yoldur.

Adım 4: Anahtarı Apidog'da saklayın ve test edin

Bir anahtarı terminale yapıştırmak bir kez işe yarar. İsteği bir ekip arkadaşıyla paylaşmak, bir model güncellemesinden sonra yeniden çalıştırmak veya CI'a koymak, bir API istemcisinin yerini kazandığı yerdir. İşte Apidog'daki akış.

Anahtarı yerel bir değer olarak saklayın. Ortamları (Environments) açın, “xAI” adında bir tane oluşturun ve iki değişken ekleyin: baseUrl için paylaşılan değer olarak https://api.x.ai/v1 ve XAI_API_KEY için paylaşılan değer olarak bir yer tutucu ve yerel değerinde gerçek anahtarınız. Paylaşılan değerler ekip arkadaşlarıyla senkronize olur; yerel değerler makinenizdeki istemcinizin önbelleğinde kalır ve Apidog sunucularına asla ulaşmaz. Değişken adı projeyle birlikte gelir, sır gelmez. Apidog ortamları ve gizli değişkenler, CI'ın kendi anahtarını nasıl enjekte ettiği de dahil olmak üzere paylaşılan ve yerel ayrımını derinlemesine kapsar.

İlk isteği gönderin. Yeni bir uç nokta oluşturun: POST {{baseUrl}}/responses. Kimlik Doğrulama (Auth) sekmesinde Bearer Token'ı seçin ve {{XAI_API_KEY}} girin. 2. Adım'dan JSON gövdesini yapıştırın, xAI ortamını seçin ve Gönder'e tıklayın. Yanıt paneli durumu, zamanlamayı ve ayrıştırılmış gövdeyi gösterir, böylece ham JSON okumak yerine output ve usage içine tıklayabilirsiniz.

Bunu bir test olarak kaydedin. İşlem Sonrası (Post Processors) bölümünde, bir Onay (Assert) adımı ekleyin: durum kodu 200'e eşit olmalı ve $.model'in grok-4.6'ya eşit olduğunu kontrol eden bir JSONPath kontrolü ekleyin. $.usage.output_tokens'ın 0'dan büyük olduğunu doğrulayan ikinci bir onay ekleyin. Uç noktayı kaydedin, Testler'i açın, bir test senaryosu oluşturun ve uç noktayı içine aktarın. Bundan sonra, tek bir tıklamayla çağrı yeniden çalıştırılır ve anahtarın, model kimliğinin ve yanıt yapısının hala çalışıp çalışmadığını size söyler.

İsteğe bağlı: taklit edin (mock). Gerçek yanıtı uç noktada bir örnek olarak kaydedin ve Apidog'un sahte (mock) URL'sine geçin. Ön uç çalışmaları ve birim testleri, kredi harcamadan veya hız sınırlarına takılmadan sahte bir Grok yanıtına karşı çalışabilir.

Limitler, krediler ve fiyatlandırma

Faturalandırma. Krediler ekip başına ön ödemelidir. Otomatik yükleme, bakiyeniz belirlediğiniz bir eşiğin altına düştüğünde (her yükleme için minimum 5$) daha fazla satın alabilir; aylık bir üst sınır ve bunun %80'inde bir uyarı ile. Aylık faturalandırma mevcuttur ancak varsayılan olarak kapalıdır ve xAI satış ekibi aracılığıyla yapılır; varsayılan 0$ faturalandırılan limit ile ön ödemeli krediler bittiği anda istekler reddedilir.

Grok 4.6 fiyatlandırması milyon jeton başına, resmi fiyatlandırma sayfasından:

İstem boyutu	Girdi	Önbelleğe alınmış girdi	Çıktı
200k jetonun altında	$2.00	$0.50	$6.00
200k jeton veya daha fazla	$4.00	$1.00	$12.00

Bağlam penceresi 500k jetondur. İsteminin 200k eşiğini aşan bir istek, yalnızca aşan kısım için değil, tüm jetonları için daha yüksek orandan faturalandırılır.

Hız limitleri. xAI, saniye başına istek ve dakika başına jeton sayısını sınırlar. Sayılar seviyenize bağlıdır: beş seviye (0'dan 4'e kadar) artı Kurumsal (Enterprise), 1 Ocak 2026'dan bu yana kümülatif harcama ile otomatik olarak açılır ve bir seviye asla düşürülmez. Ekibinizin mevcut limitleri konsoldaki Modeller sayfasında bulunur. Akıl yürütme jetonları ve önbelleğe alınmış istem jetonları dahil her jeton TPM'ye dahil edilir.

Ücretsiz krediler. xAI'ın belgeleri ön ödemeli bir modeli tanımlar ve API için kalıcı bir ücretsiz katman reklamı yapmaz. Promosyon kredileri zaman zaman konsolda görünmüştür; bir blog yazısına güvenmek yerine kendi Faturalandırma sayfanızı kontrol edin.

Sık karşılaşılan hatalar ve nasıl çözüleceği

401 Yetkilendirilmedi. Anahtar eksikti, yanlış biçimlendirilmişti veya silinmişti. Başlığın tek bir boşlukla Authorization: Bearer <key> şeklinde okunduğunu, $XAI_API_KEY'in curl çalıştıran kabukta ayarlı olduğunu (echo $XAI_API_KEY | wc -c 1'den fazla yazdırmalıdır) ve anahtarın hala konsolda bulunduğunu kontrol edin. Kopyala-yapıştır işleminden kaynaklanan sondaki bir yeni satır klasik bir nedendir.

403 Yasaklandı. Anahtar geçerli ancak istediğinizi yapmaya izin verilmiyor. Olası nedenler: anahtar veya ekip engellendi, 0$ faturalandırılan limit ile krediler tükendi veya ekibin modele erişimi yok. Önce Faturalandırma'yı, ardından API Anahtarları sayfasındaki anahtarı kontrol edin.

429 Çok Fazla İstek. Seviyeniz için RPS veya TPM tavanına ulaştınız. Gecikme ile üstel geri çekilme (exponential backoff with jitter) ekleyin, eşzamanlılığı sınırlayın, istem boyutunu kırpın ve toplu işleri Toplu API'ye (Batch API) taşıyın. Bütün gün tavanda oturuyorsanız, çözüm harcama seviyesi (spend tier) yükseltmektir, kod değil.

400 Hatalı İstek. Genellikle yanlış bir model kimliği (grok-4.6, grok-4-6 değil) veya geçersiz JSON. Hata gövdesi alanı belirtir.

Akış ve araç çağrısı hataları da dahil olmak üzere bu yanıtların daha kapsamlı bir incelemesi Grok 4.6 API istekleri nasıl test edilir ve hata ayıklanır bölümünde bulunmaktadır.

SSS (Sıkça Sorulan Sorular)

Ücretsiz bir Grok API anahtarı var mı?

Belgelenmiş kalıcı bir teklif olarak mevcut değil. API ön ödemeli kredilerle çalışır ve hızlı başlangıç kılavuzu ilk çağrıdan önce kredi yüklemenizi söyler. Amacınız Grok'u üzerine inşa etmek yerine denemekse, Grok nasıl ücretsiz kullanılır anahtar gerektirmeyen tüketici rotalarını kapsar.

Bir Grok API anahtarı OpenAI SDK ile çalışır mı?

Evet. base_url="https://api.x.ai/v1" olarak ayarlayın ve xAI anahtarınızı api_key olarak iletin. Hem client.responses.create() hem de eski client.chat.completions.create() model="grok-4.6" ile çalışır.

İsteklere hangi model kimliğini koymalıyım?

Amiral gemisi için grok-4.6. grok-4.6-latest takma adı en yeni revizyonu takip eder. grok-4.5 ve grok-4.3 gibi eski kimlikler kendi fiyatlandırmalarıyla listelenmeye devam ediyor, ancak yeni çalışmalar 4.6 üzerinde başlamalıdır.

Anahtarım sızarsa ne yapmalıyım?

API Anahtarları sayfasında hemen silin, yerine yeni bir tane oluşturun ve kullanıldığı her yerde ortam değişkenini güncelleyin. Ardından depolarınızı ve CI günlüklerinizi eski değer için arayın. Apidog'un Kurumsal planında, Gizli Tarayıcı (Secret Scanner) isteklerde, değişkenlerde, betiklerde ve belgelerde bulunan anahtarları işaretleyerek, birinin anahtarı yerel bir değer yerine paylaşılan bir değere yapıştırdığı durumları yakalar.

Sonraki adım

Artık çalışan bir Grok API anahtarınız, başarılı bir curl ve Python çağrınız ve isteğiniz Apidog'da tekrarlanabilir bir test olarak kaydedilmiş durumda. Bu testi gerçek istemlerinize yönlendirin, usage (kullanım) sayılarını izleyin ve üretim trafiği başlamadan önce harcamalarınızı ve hız limiti boşluğunuzu bileceksiniz.