Grok API’ye ilk adım: hesap, anahtar ve ilk istek

API, bir programın Grok ile doğrudan konuşmasını sağlayan kapıdır. Bu derste hesabın nasıl açıldığını, API anahtarının ne olduğunu ve ilk isteğin hangi adımlardan geçtiğini kod yazmadan anlayacaksınız. Ayrıca veri konusunda neye dikkat etmeniz gerektiğini öğreneceksiniz.

Aklınıza bir soru mu takıldı?

Sorunuzu ya da aradığınız konuyu yazın Ders bul

Bu derste neler öğreneceksiniz?

• API’nin sohbet uygulamasından farkını
• Konsolda hesap açma, kredi yükleme ve anahtar alma adımlarını
• Anahtarı neden parola gibi saklamanız gerektiğini
• API verisinin eğitimde kullanılıp kullanılmadığını ve sağlık verisi uyarısını

API nedir, kimler için?

Sohbet uygulaması insanlar içindir; API ise yazılımlar içindir. Bir web sitesinin ya da uygulamanın içinden Grok’a soru gönderip yanıt almak istiyorsanız API kullanırsınız. Kod yazmayacak olsanız bile ne olduğunu bilmeniz yararlıdır: Bir ajansın ya da yazılımcının sizin adınıza kurduğu bir sistem büyük olasılıkla bu kapıdan geçer.

xAI’nin geliştirici belgesinin giriş sayfası, ürün ailesini şöyle sıralıyor: metin üretimi, görüntü ve video (Imagine), ses, dosyalar ve koleksiyonlar, araçlar (web araması, X araması, kod çalıştırma) ve ileri kullanım başlıkları. Belgenin bazı bölümlerinde şirket adı “SpaceXSI” olarak geçiyor; konsol ve uç noktalar ise x.ai alan adını kullanıyor. Bu ders, şirketi derslerimizdeki adıyla xAI diye anıyor.

Hızlı başlangıç: hesap, kredi, anahtar

Belgenin hızlı başlangıç sayfası adımları şöyle verir. Önce console.x.ai adresinde hesap açar ve API’yi kullanmaya başlamak için hesaba kredi yüklersiniz. Sonra konsoldaki API Keys sayfasında bir anahtar oluşturursunuz. Anahtarı, bilgisayarınızda XAI_API_KEY adlı bir ortam değişkeni olarak ya da proje klasörünüzdeki bir .env dosyasında saklarsınız. Ardından bir yazılım kitaplığı (SDK) kurulur; belge JavaScript, Python ve OpenAI uyumlu seçenekleri sayıyor.

İlk metin isteği, belgenin verdiği örnekte api.x.ai adresindeki “responses” uç noktasına gider. İlk görsel isteği ise aynı alan adındaki görsel üretim uç noktasına. Örneklerde model adı geçiyor; bu adlar zamanla değiştiği için güncel adı belgeden kopyalayın. Sayfa, fiyat vermiyor ama bir fiyatlandırma sayfasına bağlanıyor; fiyatı oradan okuyun. Yaş sınırı ve ülke kısıtı hızlı başlangıç sayfasında belirtilmiyor.

Anahtar bir paroladır

API anahtarı, hesabınıza yüklü krediyi harcama yetkisi verir. Anahtarı bir kez ele geçiren herkes sizin adınıza istek gönderebilir. Bu yüzden anahtarı e-postayla göndermeyin, ekran görüntüsüne almayın, herkese açık bir kod deposuna ya da sosyal medyaya koymayın. Anahtarı yanlışlıkla paylaştıysanız konsoldan silin ve yenisini oluşturun. Bir ajansa ya da yazılımcıya anahtar veriyorsanız, ayrı bir anahtar oluşturup iş bitince silin.

Veri ve gizlilik: API ile sohbet uygulaması aynı değil

Tüketici uygulamasında girdileriniz eğitimde kullanılabilir ve ayarı siz denetlersiniz. API tarafı için xAI’nin kurumsal SSS sayfası farklı bir şey söylüyor: Kurumsal ve API verisi, girdileri ve çıktıları model eğitiminde kullanılmaz. Girdi ve çıktıların haklarını yasanın izin verdiği ölçüde müşteri korur. Sayfaya göre konuşmalar 30 gün içinde otomatik silinir; yasal zorunluluk ya da kural ihlali şüphesi varsa istisna olur. Veri, otomatik içerik sınıflandırıcılarından geçebilir.

Sağlık verisi konusunda iki resmî sayfa ayrı şeyler söylüyor. Kurumsal SSS sayfası, Eylül 2024 itibarıyla HIPAA yüklerinin desteklenmediğini yazıyor. Imagine geliştirici sayfası ise HIPAA uygunluğundan bir sözleşme ekiyle söz ediyor. Bu çelişkiyi çözemedim. Sağlık verisi göndermeyi düşünüyorsanız önce kurumunuzun hukuk birimine ve xAI satış ekibine sorun; o zamana kadar göndermeyin.

Metin çıktıları için ayrıca bir filigran uygulaması var. Belgeye göre, listelenen Grok modellerinde API metin çıktılarına görünmez bir filigran 7 Kasım 2026’dan itibaren varsayılan olarak ekleniyor. Takım yöneticisi bunu konsoldan kapatabilir. Filigran görünmezdir ve yalnızca metin içindir; görsel ve video için sayfada bir şey yazmıyor.

Adım adım uygulama

Somut iş: Küçük bir işletme sahibisiniz ve bir yazılımcıyla çalışacaksınız. Müşteri sorularına otomatik yanıt veren bir deneme kuracaksınız. Aşağıdaki adımlar sizin yapacaklarınızdır; kodu yazılımcı yazar.

1. console.x.ai adresinde işletme e-postanızla hesap açın.
2. Yazılımcıyla birlikte deneme için küçük bir kredi tutarı belirleyin; yüklemeden önce fiyatlandırma sayfasını okuyun.
3. API Keys sayfasında yalnızca bu iş için ayrı bir anahtar oluşturun.
4. Anahtarı yazılımcıya e-postayla değil, parola yöneticisi gibi güvenli bir yolla iletin.
5. İlk istekte müşteri adı, telefon, adres gibi kişisel verileri değil, uydurma örnek soruları kullanın.
6. Yanıtları gerçek müşteriye göndermeden önce kendiniz okuyun.
7. Deneme bitince anahtarı silin ve kullanılmayan krediyi kontrol edin.

Kontrol listesi

• Anahtar yalnızca bu iş için oluşturuldu.
• Anahtar herkese açık bir yere yazılmadı.
• İlk denemede kişisel veri yok.
• Yanıtlar müşteriye gitmeden önce okunuyor.

Yanlış bilgi ve sahte içerik uyarısı

API üzerinden üretilen yanıtlar da yanılabilir. Bir sistem hata yaparsa bunu binlerce müşteriye tekrarlayabilir. Aracın web ya da X araması yaptığı durumlarda da kaynak bağlantılarını kontrol edin; belge, araçların kaynak bağlantılarını döndürdüğünü yazıyor, ama bunları okumak sizin işinizdir. Görsel veya video üretiyorsanız yapay zekâ ürünü olduğunu belirtin ve gerçek kişileri izinsiz kullanmayın.

Muadiller

OpenAI, Anthropic ve Google gibi şirketlerin de geliştirici API’leri var. Belge, OpenAI kitaplıklarıyla uyumlu bir kullanım yolu sunduğunu söylüyor. Bu derste diğer API’leri incelemedim. Sıralama yapmıyorum; ihtiyacınıza, veri koşullarına ve belgelerin anlaşılırlığına göre karar verin.

Sık yapılan hatalar

• API anahtarını e-postayla ya da herkese açık bir yerde paylaşmak.
• Gerçek müşteri verisiyle ilk denemeyi yapmak.
• Sohbet uygulaması ile API’nin veri kurallarının aynı olduğunu sanmak.
• Kredi harcamasını izlememek.

Kendinizi deneyin

Kaynaklar

• xAI geliştirici belgesi: hızlı başlangıç (İngilizce)
• xAI geliştirici belgesi: giriş (İngilizce)
• xAI: kurumsal SSS (İngilizce)
• xAI geliştirici belgesi: çıktı filigranı (İngilizce)
• xAI geliştirici belgesi: araçlar (İngilizce)
• xAI geliştirici belgesi: Imagine (İngilizce)

Son kontrol: 8 Kasım 2026

Kaynak: yzdersleri.com/ders/grok-api-ye-ilk-adim-hesap-anahtar-ve-ilk-istek/ · Yapay Zeka Dersleri