Groq, farklı yapay zekâ modellerine kendi API hizmeti üzerinden erişim sağlayan bir platformdur. İsmi benzer olsa da Groq ile xAI'ın Grok'u farklı hizmetlerdir; birinin anahtarı diğerinde çalışmaz. Bu rehberde GroqCloud hesabında bir anahtar oluşturup destekleyen bir uygulamaya eklemeyi öğreneceksin. API anahtarını, uygulamanın senin hesabın adına istek göndermesine yarayan özel bir giriş bilgisi olarak düşünebilirsin; hesap şifrenin yerine paylaşılacak bir metin değildir.
Groq belgelerinde Free ve Developer kullanım katmanları ayrı anlatılıyor. Ücretsiz katmanın model ve istek sınırları vardır; her iş için sınırsız kullanım vaat edilmez. Ücretli katmana geçişte geçerli ödeme yöntemi gerekir ve kullanıma göre fatura oluşabilir. Ücretli hesaplarda kuruluş sahibi, faturalandırmanın sınırlar bölümünden aylık harcama limiti ayarlayabilir. Sayaçlar gecikmeli güncellenebildiğinden bu limiti milimetrik bir garanti gibi düşünme. Güncel şartları konsoldan ve resmî fiyatlandırmadan oku.
GroqCloud konsoluna yukarıdaki resmî bağlantıdan gir. Adresteki groq yazımını kontrol et; grok yazan başka bir platforma gitme. Hesabın yoksa kayıt ekranının sunduğu yöntemi tamamla; varsa kendi hesabınla giriş yap. Hesap doğrulama istenirse onu bitirerek konsola dön.
3 Kasım 2026 tarihinde GroqCloud’un gerçek API Keys adresinden alınmıştır. Sayfa, içeriğe erişmek için hesap veya giriş gerektiğini gösterir. Google, GitHub ve e-posta seçenekleri giriş yöntemleridir; API anahtarı üretmezler. Hesap açılmamış ve giriş gönderilmemiştir. Hesap içindeki Create API Key formu erişilemediğinden sonraki anahtar ekranı resimli olarak tamamlanmış sayılmaz. Kaynak: resmî ekran veya belge. Görsele dokunarak büyütebilirsiniz.
Kırmızı numaraların gösterdiği alanlar:
Birden çok ekip veya proje görüyorsan denemeyi hangi hesap altında yapacağını seç. Anahtar listesi proje anahtarlarını gösterir. Kendi denemen için açtığın proje ile iş yerinin üretim projesini ayırmak, yanlış hesaba kullanım yazılmasını önlemeye yardımcı olur.
3 Kasım 2026 tarihinde GroqCloud anahtar sayfasının giriş öncesi görünümünden alınan gerçek ekran. Kaynak: resmî ekran veya belge. Görseli büyütmek için üzerine dokunabilirsiniz.
Doğrudan /keys bağlantısını aç. API Keys başlığı anahtarların yönetildiği sayfadır. Bu liste bir model veya sohbet listesi değildir. Başka bir araca bağlanmak için burada oluşturacağın gizli değere ihtiyacın var; konsoldaki kullanıcı adını kopyalaman yeterli olmaz.
Create API Key düğmesini kullan. Açılan form ad istiyorsa kolay tanıyacağın bir etiket ver; örneğin YZF yazı denemesi. Formda gösterilen seçenekleri okuyup oluşturmayı tamamla. Bu işlem için ekip sahibi veya geliştirici rolü gerekir; düğme kullanılamıyorsa rolünü kontrol ettir.
Oluşan anahtarı uygulamaya eklemek üzere kopyala ve kendi parola yöneticinde sakla. Kopyaladığın metnin tamamının alındığından emin ol. Forumda yardım isterken anahtarı, ekran görüntüsünü ya da onu içeren uygulama ayarlarını paylaşma; yalnız hata mesajını ve gizli olmayan ayarları göster.
Konsoldaki güncel model listesine bak. Her model bütün özellikleri desteklemeyebilir. İlk bağlantı denemesinde uygulamanın desteklediği basit bir metin modelini seç. Bir eğitimde geçen eski model adını otomatik olarak kullanmak yerine kendi panelindeki güncel adı esas al.
Sağlayıcı listesinde Groq varsa onu seç. Anahtar kutusuna kendi gizli değerini yapıştır. Genel OpenAI uyumlu bağlantı kullanıyorsan aşağıdaki Groq servis adresini gir; OpenAI adresini bırakma. Ayarları kaydet. Sağlayıcının adı, servis adresi ve anahtar aynı hizmete ait olmalı.
Bağladığın uygulamadan Türkçe olarak Yalnızca bağlantı başarılı yaz isteğini gönder. İlk anda uzun belge veya toplu iş yükleme. Bir yanıt aldıktan sonra uygulamada doğru model ve doğru sağlayıcının seçili kaldığını kontrol et. Konsolun Playground alanı da model denemesi yapmana yardımcı olabilir.
Daha çok deneme yapmadan önce hesabının hangi kullanım katmanında olduğunu gözden geçir. Ücretli kullanımda gerekli yetkin varsa aylık bütçeyi ve bildirimlerini ayarla. Bir sınır uyarısı gördüğünde yeni anahtar üretmek yerine o uyarının model, hız veya harcama sınırından hangisine ait olduğunu ayırt et.
Kullanacağınız uygulamanın Ayarlar, Bağlantılar veya Yapay zekâ sağlayıcıları bölümünü açın. Anahtarı herkese açık bir mesaj kutusuna değil, uygulamanın bu iş için ayırdığı gizli bağlantı alanına girin. Alanların anlamı şöyledir:
Anahtar oluşturma düğmesi çalışmıyor.
Doğru proje altında olduğunu kontrol et. Resmî anahtar sayfasına göre anahtar yönetimi için ekip sahibi veya geliştirici rolü gerekir; ekip yöneticisinden erişimini kontrol etmesini iste.
Anahtar geçersiz deniyor.
Groq anahtarını Groq sağlayıcısına eklediğini doğrula. Benzer isimli Grok anahtarını kullanma; kopyalama sırasında kalan boşlukları ve servis adresini kontrol et.
Çok fazla istek veya 429 hatası çıkıyor.
Bir süre bekle, aynı isteği peş peşe tekrarlama. Hesabın ve seçili model için geçerli hız/kullanım sınırlarını resmî konsoldan incele.
Harcama limitine ulaştığım söyleniyor.
Ücretli hesabın faturalandırma sınırına bak. Kuruluş limiti tüm anahtarların ortak kullanımını kapsar; başka anahtar üretmek bu limiti sıfırlamaz. Yönetici bütçeyi kontrol etmeli.
Bilgi ve ekran kontrol tarihi: 3 Kasım 2026. Menü yerleşimi, hesap uygunluğu, model listesi ve ücretler değişebilir; işlem sırasında hesabınızda gösterilen güncel koşulları okuyun. Bu konudaki görsellerde kullanılabilir gizli API anahtarı bulunmaz.
Başlamak için açacağınız adresler
Önce ücret ve kullanım hakkını anlayın
Groq belgelerinde Free ve Developer kullanım katmanları ayrı anlatılıyor. Ücretsiz katmanın model ve istek sınırları vardır; her iş için sınırsız kullanım vaat edilmez. Ücretli katmana geçişte geçerli ödeme yöntemi gerekir ve kullanıma göre fatura oluşabilir. Ücretli hesaplarda kuruluş sahibi, faturalandırmanın sınırlar bölümünden aylık harcama limiti ayarlayabilir. Sayaçlar gecikmeli güncellenebildiğinden bu limiti milimetrik bir garanti gibi düşünme. Güncel şartları konsoldan ve resmî fiyatlandırmadan oku.
Adım adım API anahtarını alma
1. Doğru Groq adresini aç
GroqCloud konsoluna yukarıdaki resmî bağlantıdan gir. Adresteki groq yazımını kontrol et; grok yazan başka bir platforma gitme. Hesabın yoksa kayıt ekranının sunduğu yöntemi tamamla; varsa kendi hesabınla giriş yap. Hesap doğrulama istenirse onu bitirerek konsola dön.
Gerçek GroqCloud API Keys sayfasında giriş gereksinimi
3 Kasım 2026 tarihinde GroqCloud’un gerçek API Keys adresinden alınmıştır. Sayfa, içeriğe erişmek için hesap veya giriş gerektiğini gösterir. Google, GitHub ve e-posta seçenekleri giriş yöntemleridir; API anahtarı üretmezler. Hesap açılmamış ve giriş gönderilmemiştir. Hesap içindeki Create API Key formu erişilemediğinden sonraki anahtar ekranı resimli olarak tamamlanmış sayılmaz. Kaynak: resmî ekran veya belge. Görsele dokunarak büyütebilirsiniz.
Kırmızı numaraların gösterdiği alanlar:
- API Keys, açılan gerçek bölümdür; ortadaki mesaj bu bölüme giriş gerektiğini belirtir.
- Continue with Google, sunulan alternatif giriş yöntemlerinden biridir.
- Continue with GitHub, Google ve e-posta yöntemlerinden ayrı bir giriş seçeneğidir.
- E-posta alanı, e-posta ile devam etmek isteyenler içindir. [email protected] yer tutucudur; kayıtlı bilgi değildir.
- Continue with email, yazılan e-posta ile giriş akışını ilerletir; anahtar oluşturma düğmesi değildir.
2. Kullanacağın projeyi belirle
Birden çok ekip veya proje görüyorsan denemeyi hangi hesap altında yapacağını seç. Anahtar listesi proje anahtarlarını gösterir. Kendi denemen için açtığın proje ile iş yerinin üretim projesini ayırmak, yanlış hesaba kullanım yazılmasını önlemeye yardımcı olur.
Gerçek GroqCloud giriş ekranı
3 Kasım 2026 tarihinde GroqCloud anahtar sayfasının giriş öncesi görünümünden alınan gerçek ekran. Kaynak: resmî ekran veya belge. Görseli büyütmek için üzerine dokunabilirsiniz.
- 1: Anahtarların yönetildiği API Keys menüsü.
- 2: Google ile giriş alternatifi.
- 3: E-posta ile giriş tercih ederseniz adresinizi buraya yazın.
- 4: E-posta yönteminde devam etme düğmesi. Google ve e-posta yöntemlerinden birini kullanmanız yeterlidir.
3. Anahtarlar sayfasına git
Doğrudan /keys bağlantısını aç. API Keys başlığı anahtarların yönetildiği sayfadır. Bu liste bir model veya sohbet listesi değildir. Başka bir araca bağlanmak için burada oluşturacağın gizli değere ihtiyacın var; konsoldaki kullanıcı adını kopyalaman yeterli olmaz.
4. Yeni anahtar oluştur
Create API Key düğmesini kullan. Açılan form ad istiyorsa kolay tanıyacağın bir etiket ver; örneğin YZF yazı denemesi. Formda gösterilen seçenekleri okuyup oluşturmayı tamamla. Bu işlem için ekip sahibi veya geliştirici rolü gerekir; düğme kullanılamıyorsa rolünü kontrol ettir.
5. Gizli değeri güvenli sakla
Oluşan anahtarı uygulamaya eklemek üzere kopyala ve kendi parola yöneticinde sakla. Kopyaladığın metnin tamamının alındığından emin ol. Forumda yardım isterken anahtarı, ekran görüntüsünü ya da onu içeren uygulama ayarlarını paylaşma; yalnız hata mesajını ve gizli olmayan ayarları göster.
6. Erişilebilir modelleri kontrol et
Konsoldaki güncel model listesine bak. Her model bütün özellikleri desteklemeyebilir. İlk bağlantı denemesinde uygulamanın desteklediği basit bir metin modelini seç. Bir eğitimde geçen eski model adını otomatik olarak kullanmak yerine kendi panelindeki güncel adı esas al.
7. Uygulamanın bağlantısını doldur
Sağlayıcı listesinde Groq varsa onu seç. Anahtar kutusuna kendi gizli değerini yapıştır. Genel OpenAI uyumlu bağlantı kullanıyorsan aşağıdaki Groq servis adresini gir; OpenAI adresini bırakma. Ayarları kaydet. Sağlayıcının adı, servis adresi ve anahtar aynı hizmete ait olmalı.
8. Tek, kısa bir istekle dene
Bağladığın uygulamadan Türkçe olarak Yalnızca bağlantı başarılı yaz isteğini gönder. İlk anda uzun belge veya toplu iş yükleme. Bir yanıt aldıktan sonra uygulamada doğru model ve doğru sağlayıcının seçili kaldığını kontrol et. Konsolun Playground alanı da model denemesi yapmana yardımcı olabilir.
9. Kullanımı ve sınırını izle
Daha çok deneme yapmadan önce hesabının hangi kullanım katmanında olduğunu gözden geçir. Ücretli kullanımda gerekli yetkin varsa aylık bütçeyi ve bildirimlerini ayarla. Bir sınır uyarısı gördüğünde yeni anahtar üretmek yerine o uyarının model, hız veya harcama sınırından hangisine ait olduğunu ayırt et.
Aldığım anahtarı uygulamaya nereye yazacağım?
Kullanacağınız uygulamanın Ayarlar, Bağlantılar veya Yapay zekâ sağlayıcıları bölümünü açın. Anahtarı herkese açık bir mesaj kutusuna değil, uygulamanın bu iş için ayırdığı gizli bağlantı alanına girin. Alanların anlamı şöyledir:
- Sağlayıcı: Groq. Grok veya xAI seçeneği değildir.
- API Key: GroqCloud'da oluşturduğun tam gizli değer. Groq hesabının parolasını yazma.
- Base URL: https://api.groq.com/openai/v1. Yalnız genel OpenAI uyumlu bağlantı bunu soruyorsa gir; yerleşik seçenek adresi kendisi ayarlayabilir.
- Model: Groq konsolundaki güncel ve erişilebilir model. Uygulamanın istediğin özelliği desteklediğini de kontrol et.
Sık karşılaşılan sorunlar ve çözümleri
Anahtar oluşturma düğmesi çalışmıyor.
Doğru proje altında olduğunu kontrol et. Resmî anahtar sayfasına göre anahtar yönetimi için ekip sahibi veya geliştirici rolü gerekir; ekip yöneticisinden erişimini kontrol etmesini iste.
Anahtar geçersiz deniyor.
Groq anahtarını Groq sağlayıcısına eklediğini doğrula. Benzer isimli Grok anahtarını kullanma; kopyalama sırasında kalan boşlukları ve servis adresini kontrol et.
Çok fazla istek veya 429 hatası çıkıyor.
Bir süre bekle, aynı isteği peş peşe tekrarlama. Hesabın ve seçili model için geçerli hız/kullanım sınırlarını resmî konsoldan incele.
Harcama limitine ulaştığım söyleniyor.
Ücretli hesabın faturalandırma sınırına bak. Kuruluş limiti tüm anahtarların ortak kullanımını kapsar; başka anahtar üretmek bu limiti sıfırlamaz. Yönetici bütçeyi kontrol etmeli.
Resmî kaynaklar
- Groq: Başlangıç rehberi
- Groq: API anahtarları ve rol şartı
- Groq: OpenAI uyumlu bağlantı adresi
- Groq: Faturalandırma soruları
- Groq: Harcama sınırları
Bilgi ve ekran kontrol tarihi: 3 Kasım 2026. Menü yerleşimi, hesap uygunluğu, model listesi ve ücretler değişebilir; işlem sırasında hesabınızda gösterilen güncel koşulları okuyun. Bu konudaki görsellerde kullanılabilir gizli API anahtarı bulunmaz.
