repeat.cards logosurepeat.cards

Kurulum rehberi · Bir değil, iki Google anahtarı

API anahtarlarını adım adım oluştur.

Kendi API anahtarlarını kullanmayı tercih edersen repeat.cards üç tür anahtarı destekler. OpenAI anahtarı ayrı bir hizmet içindir. Gemini ve Cloud Text-to-Speech ise farklı yerlerden alınan iki Google anahtarı gerektirir. Her birini nasıl oluşturacağını aşağıda bulabilirsin.

Kendi anahtarlarınla çalışmak istersen repeat.cards uygulamasına OpenAI, Gemini ve Cloud Text-to-Speech anahtarları ekleyebilirsin. İki Google anahtarı farklı konsollardan alınır ve birbirinin yerine kullanılamaz. Üçünü birden alman gerekmez; kullanmak istediğin özelliklere uygun olanları seç.

Hangi özellik için hangi anahtar gerekir?

Çeviriler, kelime kontrolü, hafıza ipuçları, örnek cümleler, kart sohbeti

Kullanılabilecek anahtar
OpenAI veya Gemini – hangi modeli seçersen

Ekran görüntüsünden kelime okuma

Kullanılabilecek anahtar
OpenAI veya Gemini – hangi modeli seçersen

Sesli telaffuz

Kullanılabilecek anahtar
OpenAI veya Cloud Text-to-Speech

Kartlardaki görseller

Kullanılabilecek anahtar
Yalnızca OpenAI

Üç anahtarı aynı hesaba ekleyebilirsin. Her birini ayrı kaydedebilir, değiştirebilir veya kaldırabilirsin. Bir anahtarı kaldırırsan onu kullanan özellikler için başka uygun bir anahtar gerekir.

OpenAI API anahtarı

OpenAI anahtarını platformun API keys sayfasından oluşturabilirsin. API kullanımı, ChatGPT aboneliğinden ayrı ücretlendirilir ve ön ödemeli kredi gerektirir.

  1. platform.openai.com adresinde giriş yap. ChatGPT hesabın burada çalışır. API, herhangi bir ChatGPT aboneliğinden ayrı faturalandırılır; insanları en çok şaşırtan kısım da budur.
  2. API keys sayfasını aç. Sol menüdedir; ya da doğrudan platform.openai.com/api-keys adresine git.
  3. Yeni bir gizli anahtar oluştur (Create new secret key). “Owned by” ayarını You olarak bırak, anahtara daha sonra tanıyacağın bir ad ver ve Permissions ayarını All olarak bırak. repeat.cards birkaç OpenAI uç noktası kullanır; bu yüzden kısıtlanmış bir anahtar, dışarıda bıraktığın uç noktada hata verir.
  4. Hemen kopyala. OpenAI gizli anahtarı yalnızca bir kez gösterir, bir daha asla. Anahtar sk- ile başlar. Kaybedersen sil ve yenisini oluştur – onu yeniden görmenin bir yolu yok.
  5. Kredi ekle. Settings → Billing bölümünden kredi ekle. API, ön ödemeli krediyle çalışır; ChatGPT Plus veya Pro aboneliği API kullanımını kapsamaz.
  6. repeat.cards uygulamasına yapıştır. “Profil → Yapay zekâ ayarları → OpenAI API anahtarı” alanına yapıştır, ardından “Kaydet” düğmesine bas.

Faturalandırma: Gerekli. Herhangi bir ChatGPT aboneliğinden ayrı satın alınan ön ödemeli kredi.

OpenAI’ın Create new secret key penceresi: anahtarın adı repeat.cards, Owned by ayarı You, Permissions ayarı All
Owned by ayarını You, Permissions ayarını All olarak bırak. (platform.openai.com, Ağustos 2026)

Gemini API anahtarı

Gemini ve telaffuz için ayrı Google anahtarları gerekir.

Gemini anahtarını oluşturmak için aşağıdaki Google AI Studio adımlarını izle. Google Cloud konsolunu kullanman gerekiyorsa ek kısıtlamalar vardır; ayrıntıları bu bölümün sonunda bulabilirsin. Her iki durumda da Cloud Text-to-Speech ile telaffuz oluşturmak için ayrı bir anahtar gerekir.

  1. aistudio.google.com/apikey adresine git. Herhangi bir Google hesabıyla giriş yap. Burası Google AI Studio’dur – farklı türde bir anahtar veren Google Cloud konsolu değil.
  2. Create API key düğmesine bas. Düğme, API Keys sayfasının sağ üst köşesindedir.
  3. Bir proje seç. Gemini anahtarı her zaman bir Google Cloud projesine aittir; pencerenin proje sormasının nedeni budur. Hiç projen yoksa aynı açılır listede Create project seçeneğini seç ve istediğin bir ad ver – repeat-cards olabilir.
  4. Anahtarı oluştur ve kopyala. AI Studio’nun verdiği anahtarlar AQ ile başlar. Google bunlara auth key (kimlik doğrulama anahtarı) der ve Gemini API’nin beklediği tür budur.
  5. repeat.cards uygulamasına yapıştır. “Profil → Yapay zekâ ayarları → Gemini API anahtarı” alanına yapıştır, ardından “Kaydet” düğmesine bas. repeat.cards anahtarın çalışıp çalışmadığını Google’a sorar ve cevabı Google’ın kendi sözcükleriyle gösterir; böylece sorunu ilk kartında değil, hemen öğrenirsin.

Faturalandırma: Başlamak için gerekli değil. AI Studio ücretsiz katmanda anahtar verir; ücretli katman için projede bir faturalandırma hesabı gerekir.

Google AI Studio’daki API Keys sayfası: ücretsiz katmandaki repeat-cards adlı projede bir Gemini API anahtarı, sağ üstte Create API key düğmesi
Create API key sağ üsttedir. Anahtar bir projeye aittir ve ücretsiz katman faturalandırma hesabı gerektirmez. (Google AI Studio, Ağustos 2026)
Google AI Studio’daki Create a new key penceresi: proje açılır listesi açık; mevcut projelerin yanında Import project ve Create project seçenekleri
Henüz projen yok mu? Create project, proje seçtiğin aynı açılır listede. (Google AI Studio, Ağustos 2026)

Bunun yerine Cloud konsolunu kullanmak zorundaysan

Bazı kuruluşlar AI Studio’ya izin vermez. Google Cloud konsolunda oluşturulan bir Gemini anahtarı çalışır, ama sana iki şeye mal olur. Anahtarın Gemini API ile kısıtlanması gerekir, çünkü bu türden kısıtlanmamış bir anahtar doğrudan reddedilir – ayrıca Ağustos 2026 itibarıyla konsol, Gemini API’leri için bir anahtarın bir hizmet hesabına bağlanması gerektiğini de belirtiyor; bu adım bu rehberin kapsamında değil.

Bu kısıtlama, aynı anahtarı Text-to-Speech için kullanmanı engeller. Google’ın API kısıtlamaları, Gemini API anahtarının başka bir hizmetle paylaşılmasına izin vermez. Bu nedenle telaffuz için ayrı bir anahtar oluşturman gerekir.

Cloud Text-to-Speech API anahtarı

Cloud Text-to-Speech anahtarını Google Cloud konsolundan oluşturursun. Bu anahtar Gemini anahtarından farklıdır. Ses oluşturabilmek için projede faturalandırmayı ve doğru API’yi etkinleştirmen gerekir.

  1. console.cloud.google.com adresini aç ve bir proje seç. Üst çubuktaki proje seçiciyi kullan ya da bir proje oluştur – herhangi bir ad olur. Burası Google Cloud konsoludur, AI Studio’dan farklı bir yerdir.
  2. O projeye bir faturalandırma hesabı bağla. Text-to-Speech, faturalandırma hesabı olmayan bir projede, Google’ın aylık ücretsiz kullanım hakkı içinde bile hiçbir ses oluşturmaz. Google’ın güncel fiyatları kendi fiyatlandırma sayfasında.
  3. Cloud Text-to-Speech API’yi etkinleştir. APIs & Services → Library (Türkçe arayüzde API’ler ve Hizmetler → Kitaplık) bölümünde “text-to-speech” diye ara, Cloud Text-to-Speech API’yi aç ve Enable (Etkinleştir) düğmesine bas. Başka hiçbir şeyi etkinleştirmen gerekmez.
  4. Anahtarı oluştur. APIs & Services → Credentials → Create credentials → API key (Türkçe arayüzde API’ler ve Hizmetler → Kimlik Bilgileri → Kimlik bilgileri oluştur → API anahtarı).
  5. Yalnızca Cloud Text-to-Speech API’yi seç. Select API restrictions altında yalnızca Cloud Text-to-Speech API’yi işaretle. Alan zorunludur, yani burada artık kısıtlamasız bir seçenek yok. Bu anahtara Gemini API’yi ekleme: Gemini ile kısıtlanmış bir anahtar Text-to-Speech isteklerine API_KEY_SERVICE_BLOCKED ile cevap verir ve Google, Gemini API’nin bir anahtarı başka bir hizmetle paylaşmasına izin vermez. Kartlarını sessiz bırakan tam olarak bu kısıtlamadır.
  6. Kopyala ve repeat.cards uygulamasına yapıştır. Anahtar AIza ile başlar. “Profil → Yapay zekâ ayarları → Cloud Text-to-Speech API anahtarı” alanına yapıştır, ardından “Kaydet” düğmesine bas.

Faturalandırma: Gerekli. API, faturalandırma hesabı bağlı olmayan bir projede ses oluşturmayı reddeder.

Google Cloud konsolundaki New Project formu: proje adı repeat-cards
Herhangi bir proje adı olur; proje kimliği bu addan oluşturulur ve sonradan değiştirilemez. (Google Cloud konsolu, Ağustos 2026)
Google Cloud API kitaplığında iki sonuç: Cloud Speech-to-Text API’nin yanında Cloud Text-to-Speech API
text-to-speech aramasında iki benzer hizmet görebilirsin. İhtiyacın olan Cloud Text-to-Speech, metni sese dönüştürür. Speech-to-Text ise sesi metne çevirir. Cloud Text-to-Speech sayfasında Enable düğmesine bas; etkinleştirildiğinde düğme Manage olarak değişir. (Google Cloud konsolu, Ağustos 2026)
Google Cloud konsolundaki Create API key paneli: Select API restrictions altında tek bir API seçili, Cloud Text-to-Speech API
Select API restrictions alanında yalnızca Cloud Text-to-Speech API seçili olmalı. (Google Cloud konsolu, Ağustos 2026)

API anahtarları hakkında sık sorulan sorular

Tek bir Google anahtarı hem Gemini’yi hem telaffuzu karşılayabilir mi?
Hayır. AI Studio’dan alınan Gemini anahtarı, Text-to-Speech için uygun değildir. Cloud konsolundan alınan bir anahtarı Gemini API için kısıtladığında ise Text-to-Speech istekleri engellenir. Bu nedenle iki hizmet için ayrı anahtarlar kullanılır ve repeat.cards uygulamasında da iki ayrı alan bulunur.
Zaten bir Google anahtarım vardı ve kartlarımın sesi çalışmayı bıraktı.
Büyük olasılıkla yapay zekâ özelliklerini çalıştırmak için onu Gemini API ile kısıtladın. Bu kısıtlama Text-to-Speech’i engeller ve API_KEY_SERVICE_BLOCKED cevabı döner. Çözüm ikinci bir anahtar: kısıtlı olanı Gemini alanında tut, telaffuz alanı için de Cloud Text-to-Speech ile kısıtlanmış yeni bir anahtar oluştur.
Üç anahtara da ihtiyacım var mı?
Hayır. Yalnızca kullanmak istediğin özellikler için gereken anahtarları oluştur. Metin özellikleri, hangi modeli seçtiğine göre OpenAI ya da Gemini anahtarıyla çalışır. Telaffuz, OpenAI ya da Cloud Text-to-Speech anahtarıyla çalışır. Kartlardaki görseller yalnızca OpenAI ile çalışır. Bir hesap üçünü aynı anda tutabilir ve her biri ayrı ayrı kaydedilir, değiştirilir ve kaldırılır.
repeat.cards kaydettiğim bir anahtarla ne yapar?
Anahtar hesabında saklanır ve yalnızca ilgili hizmete gönderilir: Gemini anahtarı Gemini’ye, telaffuz anahtarı Text-to-Speech’e. Uygulamada anahtarın yalnızca bir kısmı gösterilir. Aynı ekrandaki “Kaldır” düğmesiyle silebilirsin.
Ekranlar buradaki görsellere benzemiyor.
Bu sayfadaki ekran görüntüleri Ağustos 2026 tarihinde alındı ve Google’ın ve OpenAI’ın kimseye haber vermeden değiştirdiği konsolları gösteriyor. Aranacak adlar – Create API key, API restrictions, Cloud Text-to-Speech API – düzenden daha uzun ömürlüdür; bu yüzden piksellerden çok sözcükleri takip et. Yanıltacak kadar değişmiş bir ekran fark edersen iletişim sayfasından bize bildir, ekran görüntüsünü yeniden alalım.

Anahtarlarını ekle, kartlarını hazırlamaya başla.

Çeviri, örnek cümle, hafıza ipucu ve telaffuz için kendi yapay zekâ hizmeti hesabını kullan. repeat.cards ek ücret almaz.

Yapay zekâ ayarlarını aç

Her anahtar ayrı saklanır, maskelenir ve tek başına kaldırılabilir