Yapay zeka API anahtarı alma ve Mubido'ya ekleme

Başlamadan önce

Hangi anahtar ne işe yarar

Mubido'daki özelliklerin hangi sağlayıcının anahtarıyla çalıştığı:

• Anthropic (Claude)

  Metin işlerinin varsayılanı: ürün, kategori ve marka açıklamaları, SEO başlık/açıklama, blog yazısı, müşteri sorusu taslak cevabı, panel asistanı, pazaryeri kategori eşleme, yorum spam filtresi.

• OpenAI (GPT)

  Blog kapak görseli (GPT Image) ve Banner Stüdyosu. Model Tercihleri'nden seçerseniz metin işlerini de GPT modelleriyle yaptırabilirsiniz.

• Google AI Studio (Gemini)

  Ürün sayfasındaki AI ile üret penceresinde Nano Banana ve Imagen 4 Ultra ile ürün görseli üretimi. Model Tercihleri'nden seçerseniz metin işlerini Gemini 3.6 Flash / Pro ile de yaptırabilirsiniz.

Anthropic (Claude) anahtarı

1. 1

   Adım 1: Claude Console hesabı açın

   platform.claude.com adresine gidin (eski adı console.anthropic.com) ve e-posta ya da Google hesabınızla kaydolun. Claude.ai'de hesabınız varsa aynı e-postayla girebilirsiniz; ancak API faturası Claude.ai aboneliğinden ayrıdır.

2. 2

   Adım 2: Ödemeyi açın ve kredi yükleyin

   Panelde: Settings›Billing

   Sol menüden Settings → Billing sayfasını açın, kartınızı ekleyip kredi satın alın. Claude API ön ödemelidir: bakiye sıfırsa anahtar doğru olsa bile hiçbir istek çalışmaz.

   Başlangıç için küçük bir tutar yeterlidir; tüketimi gördükçe artırırsınız. Aynı sayfada otomatik yeniden yükleme seçeneği varsa ve açarsanız mutlaka bir üst sınır da verin.

3. 3

   Adım 3: API anahtarını oluşturun

   Panelde: Settings›API keys›Create key

   Settings → API keys sayfasında Create key deyin, anahtara "mubido" gibi bir ad verin ve oluşturun.

   Anahtar sk-ant- ile başlar ve yalnız bir kez gösterilir. Hemen kopyalayın; kaybederseniz yenisini oluşturursunuz.

   Admubido

   Anahtarsk-ant-api03-••••••••

OpenAI (GPT) anahtarı

1. 1

   Adım 1: OpenAI Platform hesabı açın

   platform.openai.com adresinde kaydolun ya da ChatGPT hesabınızla giriş yapın. ChatGPT Plus/Pro aboneliği API kullanımını içermez; API ayrı faturalanır.

2. 2

   Adım 2: Ödeme yöntemi ekleyin ve kredi yükleyin

   Panelde: Settings›Billing

   Settings → Billing sayfasına gidin, ödeme yönteminizi ekleyin ve kredi satın alın. Kredi yüklemeden yapılan istekler çoğunlukla "kota aşıldı" hatasıyla döner.

   Harcama sınırı için Settings → Limits sayfasında aylık harcama sınırı ve uyarı tanımlayın. Uyarı yalnız bildirim gönderir; sert sınır (hard limit) aşılınca istekler durur.

3. 3

   Adım 3: API anahtarını oluşturun

   Panelde: API keys›Create new secret key

   platform.openai.com/api-keys sayfasında Create new secret key deyin, "mubido" adını verin ve oluşturun.

   Anahtar sk- ile başlar ve yalnız oluşturulduğu anda tam görünür. Kopyalayıp hemen Mubido'ya ekleyin.

   Namemubido

   Secret keysk-proj-••••••••

Google AI Studio (Gemini, Nano Banana, Imagen) anahtarı

1. 1

   Adım 1: AI Studio'ya giriş yapın

   aistudio.google.com adresine Google hesabınızla girin ve kullanım şartlarını kabul edin. İlk girişte sizin için bir Google Cloud projesi ve bu projeye bağlı bir anahtar kendiliğinden oluşturulabilir.

2. 2

   Adım 2: API anahtarını oluşturun

   Panelde: API Keys›Create API key

   aistudio.google.com/apikey sayfasında Create API key deyin ve anahtarın bağlanacağı projeyi seçin. Hangi projeyi seçtiğinizi not edin; ödeme bu projede açılacak.

   Anahtarı kopyalayın.

3. 3

   Adım 3: Projede faturalandırmayı açın

   Panelde: API keys›Billing Tier›Set up billing

   API anahtarları (ya da Projects) sayfasında, anahtarınızın projesinin Billing Tier sütununda Set up billing deyin. Ülkenizi seçin, ödeme bilgilerinizi girin; hesabınıza ön ödemeli kredi yüklemeniz istenebilir (en az 5 USD).

   Projenin durumu "Free"den ücretli katmana (Tier 1) geçince anahtar görsel üretimine hazırdır.

4. 4

   Adım 4: Harcama tavanı koyun

   Panelde: Spend›Monthly spend cap›Edit spend cap

   AI Studio'daki Spend sayfasında Monthly spend cap bölümünden proje için aylık tavan girin. Google bu özelliği deneysel olarak sunuyor ve tavanın birkaç dakika gecikmeyle uygulanabileceğini belirtiyor; tavanı ihtiyacınızın biraz altında tutun.

Anahtarı Mubido'ya ekleyin

1. 1

   Adım 1: AI Ayarları sayfasını açın

   Panelde: Yapay Zeka›AI Ayarları

   Panelde sol menüden Yapay Zeka → AI Ayarları sayfasını açın. Üç kart görürsünüz: Anthropic (Claude) API Anahtarı, OpenAI API Anahtarı ve Google AI Studio (Gemini) API Anahtarı.

   Anthropic (Claude) API AnahtarıTanımlı değil

   OpenAI API AnahtarıTanımlı değil

   Google AI Studio (Gemini) API AnahtarıTanımlı değil

2. 2

   Adım 2: Anahtarı yapıştırıp kaydedin

   İlgili kartta Anahtarı yapıştırın yazan kutuya anahtarınızı yapıştırın ve Kaydet deyin. Kartın sağ üstündeki rozet Tanımlı olur ve anahtarın yalnız baş ve son birkaç karakteri görünür.

   Anahtar şifreli saklanır, panelde bir daha tam hâliyle gösterilmez. Değiştirmek için kutuya yeni anahtarı yapıştırıp yine Kaydet deyin; kaldırmak için çöp kutusu simgesine basın.

   Anahtar••••••••••••

   Tanımlı (sk-a...x9QzAb)

3. 3

   Adım 3: Model tercihlerinizi seçin

   Panelde: AI Ayarları›Model Tercihleri

   Aynı sayfanın altındaki Model Tercihleri listesinde her iş (ör. Ürün — Detaylı açıklama, Blog — Kapak görseli, Panel Asistanı — Sohbet) için hangi modelin çalışacağını seçersiniz. Seçmezseniz Varsayılan kullanılır: kalite isteyen işlerde Claude Sonnet 5, kısa işlerde Claude Haiku 4.5, blog kapağında GPT Image 2.

   Metin işlerinde Claude, GPT ve Gemini modellerinden istediğinizi seçebilirsiniz; listede her modelin 1 milyon token başına girdi/çıktı fiyatı (USD) yazar. Yalnız Google anahtarınız varsa metin işlerinde Gemini 3.6 Flash ucuz ve hızlı bir başlangıçtır.

   Ürün — Detaylı açıklamaVarsayılan (Claude Sonnet 5)

   Ürün — SEO başlıkGemini 3.6 Flash

   Blog — Kapak görseliVarsayılan (GPT Image 2)

4. 4

   Adım 4: Çalıştığını deneyin

   Bir ürünü açıp açıklama alanının yanındaki AI Üret düğmesine basın. Metin geldiyse metin anahtarınız çalışıyor.

   Görsel için kayıtlı bir ürünün Görseller bölümünde AI ile üret deyin; açılan AI ile Görsel Üret penceresinde Model (provider) olarak Nano Banana ya da Imagen 4 Ultra seçin. Bu iki model Google anahtarınızla çalışır.

   Bir şey ters giderse Yapay Zeka → AI Kullanım Logları sayfasında ilgili satırın Durum sütununda Hata görünür; üzerine geldiğinizde sağlayıcının hata mesajını okursunuz. Aşağıdaki tablodan karşılığını bulun.

Anahtarınızı güvende tutun

Sık hatalar ve çözümleri

AI Kullanım Logları'nda ya da işlem sırasında gördüğünüz İngilizce mesajın karşılığı:

• "Your credit balance is too low to access the Anthropic API"

  Anthropic hesabınızda kredi yok. Claude.ai aboneliği bu bakiyeyi doldurmaz. Claude Console'da Settings → Billing sayfasından kredi satın alın; yükleme sonrası birkaç dakika içinde istekler çalışır.

• Google 429: "You exceeded your current quota" / "free_tier_requests, limit: 0"

  Anahtarınızın projesi ücretsiz katmanda ve görsel modellerinin ücretsiz kotası sıfır. AI Studio'da anahtarın bağlı olduğu projede Set up billing ile faturalandırmayı açın. Bekleyerek düzelmez.

• Google 503: "This model is currently experiencing high demand"

  Google tarafında geçici yoğunluk; sizin hesabınızla ilgili değil. Birkaç dakika sonra tekrar deneyin. Sürerse Model Tercihleri'nden başka bir model seçin (ör. Gemini 3.6 Flash yerine Pro ya da bir Claude modeli).

• OpenAI 429: "You exceeded your current quota"

  OpenAI hesabınızda kredi yok ya da koyduğunuz bütçe doldu. ChatGPT Plus bu kotayı karşılamaz. platform.openai.com → Settings → Billing sayfasından kredi yükleyin ya da Limits sayfasındaki bütçeyi yükseltin.

• Google 402 / bakiye sıfır

  Google projeniz ön ödemeli ve kredisi bitti. AI Studio'daki Billing sayfasından kredi ekleyin ya da otomatik yeniden yüklemeyi bir aylık sınırla açın.

• "... API anahtarı tanımlı değil. AI Ayarları sayfasından ekleyin."

  Seçili modelin sağlayıcısına ait anahtar panelde yok ve başka sağlayıcının anahtarı da yok. Yapay Zeka → AI Ayarları'nda en az bir anahtar girin.

• "... API anahtarı çözülemedi (bozuk); lütfen yeniden girin."

  Kayıtlı anahtar okunamadı. Sağlayıcıdan yeni bir anahtar oluşturup ilgili karta yapıştırın ve Kaydet deyin.

• 401 / "invalid x-api-key" / "Incorrect API key" / "API key not valid"

  Anahtar eksik kopyalanmış, silinmiş ya da başka sağlayıcının kartına yapıştırılmış. Claude anahtarı sk-ant-, OpenAI anahtarı sk- ile başlar; Google anahtarını yalnız Google kartına girin.

Sık sorulan sorular