Yapay Zeka API'si Nedir? Kod Bilmeden Kullanmanın Tam Rehberi

Yapay Zeka API'si Nedir? Kod Bilmeyenler İçin Eksiksiz Rehber

Yazar: mindi · ~12 dakika okuma

İçindekiler

1. API Nedir? Gerçekten Basit Anlatım
2. Yapay Zeka API'si Nedir?
3. Neden API Kullanmak İsteyeyim?
4. Hangi Şirketlerin API'si Var?
5. API Anahtarı Nedir, Nasıl Alınır?
6. Ücretler Nasıl İşliyor?
7. Riskler ve Dikkat Edilmesi Gerekenler
8. Kod Bilmeden API Kullanabilir miyim?
9. İlk Adımlar — Nereden Başlamalıyım?

1. API Nedir? Gerçekten Basit Anlatım

Şunu hayal edin: Bir restorana gittiniz. Mutfağa geçip kendi yemeğinizi pişiremezsiniz — bunun yerine garsona söylersiniz, garson mutfağa iletir, mutfak pişirir, garson size getirir.

İşte API tam olarak bu garsondur.

Siz bir istek gönderirsiniz → API bu isteği ilgili sisteme iletir → sistem işler → API size cevabı geri getirir.

Teknik dilde şöyle tanımlanır: "İki yazılımın birbiriyle konuşmasını sağlayan arayüz." Ama bu tanım işimize yaramıyor. Asıl önemli olan şu:

API sayesinde bir yazılımın gücünü, o yazılımı satın almak veya kendiniz kurmak zorunda kalmadan kullanabilirsiniz.

Örnek: Hava durumu uygulamaları kendi uydu ağını işletmez. Meteoroloji servisleri ile API üzerinden konuşurlar. Yandex Harita'nın altındaki harita verisi Yandex'e ait değildir — Google Maps ya da başka bir harita servisinin API'sini kullanır.

2. Yapay Zeka API'si Nedir?

Yapay zeka API'si, ChatGPT veya Claude gibi güçlü dil modellerini kendi uygulamanıza, aracınıza veya iş akışınıza entegre etmenizi sağlayan bir hizmettir.

Yani şöyle düşünün:

• ChatGPT web sitesi → OpenAI'nin hazırladığı, herkese açık arayüz. Siz yazarsınız, cevap alırsınız. Bitti.
• OpenAI API → Aynı yapay zeka motoru ama bu sefer sizin programınız, aracınız veya otomasyonunuz üzerinden kullanabilirsiniz.

Fark nedir? Web sitesinde sadece siz kullanırsınız, sadece elle yazarsınız. API ile ise:

• Kendi uygulamanıza yapay zeka ekleyebilirsiniz
• Binlerce soruyu otomatik olarak işletebilirsiniz
• Başka araçlarla (Excel, Google Sheets, n8n, Make gibi) entegre edebilirsiniz
• Kendi özel sistem talimatlarınızı kalıcı olarak uygulayabilirsiniz

3. Neden API Kullanmak İsteyeyim?

Bir kaç gerçek hayat senaryosu:

Senaryo 1 — E-ticaret yapıyorsunuz
500 ürününüzün Türkçe açıklamalarını tek tek yazmak yerine, tüm ürün isimlerini bir listeye koyuyorsunuz ve API otomatik olarak hepsini yazıyor. Bir saatlik iş, beş dakikaya iniyor.

Senaryo 2 — Müşteri hizmetleri
Sık sorulan sorulara otomatik yanıt veren bir chat botu kuruyorsunuz. Kullanıcı web sitenize gelip soru soruyor, yapay zeka cevaplıyor. Siz uyurken bile çalışıyor.

Senaryo 3 — İçerik üreticisi
Her gün 10 farklı sosyal medya gönderisi üretmeniz lazım. API ile otomatik olarak çeşitli içerikler ürettiriyorsunuz, siz sadece seçip yayınlıyorsunuz.

Senaryo 4 — Veri analizi
Yüzlerce müşteri yorumunu okuyup analiz etmek saatler alır. API'ye gönderiyorsunuz, "Olumlu mu, olumsuz mu, neden?" diye soruyorsunuz — saniyeler içinde analiz geliyor.

Senaryo 5 — Vibe coding / no-code
Cursor, Windsurf veya Claude Code gibi araçlarla hiç kod bilmeden uygulama geliştiriyorsunuz. Bu araçların arkasında zaten bir yapay zeka API'si çalışıyor. Kendi API anahtarınızı bağlayarak bu araçları kullanabilirsiniz.

4. Hangi Şirketlerin API'si Var?

Büyük oyuncular şunlardır:

Başlangıç için ne öneririm?

Yeni başlıyorsanız OpenAI API ile başlayın. Dünyanın en geniş topluluk desteğine sahip, dokümantasyonu en iyi, entegrasyon için en fazla rehber bulunan seçenek.

Daha sonra ihtiyacınıza göre diğerlerine geçebilir veya birden fazlasını kullanabilirsiniz. "Hepsini denemeden karar veremem" diyorsanız üçüncü bir yol da var: Ücretsiz Yapay Zeka API'si mi Lazım? OpenRouter Rehberi — tek anahtarla 300'den fazla modele erişim.

5. API Anahtarı Nedir, Nasıl Alınır?

API kullanmak için bir API anahtarı (API key) almanız gerekir. Bu anahtar, sisteme "ben buyum, bu isteği ben gönderiyorum" demenizi sağlayan özel bir şifredir.

Banka kartı şifreniz gibi düşünün — kimseyle paylaşmayın, ekran görüntüsüne koymayın.

OpenAI API Anahtarı Nasıl Alınır?

1. Adım — Hesap oluşturun

platform.openai.com adresine gidin ve kayıt olun. E-posta ve telefon numarası gerekiyor.

2. Adım — Bakiye yükleyin

Sol menüden Billing (Fatura) bölümüne gidin. Kredi/banka kartınızı ekleyin ve en az 5 dolar yükleyin. API kullandıkça bu bakiyeden düşecek.

⚠️ Önemli: Mutlaka Spending Limit (Harcama Limiti) belirleyin. Örneğin aylık 20 dolar sınır koyun. Yoksa beklenmedik bir hata veya döngü, bakiyenizi hızla bitirebilir.

3. Adım — API anahtarını oluşturun

Sol menüden API Keys bölümüne gidin. "Create new secret key" butonuna tıklayın.

Size sk-proj-... ile başlayan uzun bir kod verilecek.

🔴 Dikkat: Bu kodu bir kez görebilirsiniz. Hemen bir yere not edin — not defteri, şifre yöneticisi veya güvenli bir dosya. Pencereyi kapatırsanız bir daha göremezsiniz, yeni anahtar oluşturmanız gerekir.

4. Adım — Anahtarı kullanmaya başlayın

Bu anahtarı kullanacağınız araca yapıştırırsınız. Araç bu sayede OpenAI'ye bağlanabilir.

6. Ücretler Nasıl İşliyor?

Bu kısmı iyi anlayın — API kullanımı bedava değildir ama düşündüğünüzden çok daha ucuzdur.

Token Nedir?

API'ler token adı verilen birimle hesaplanır. Token kelime değil ama kelimeye yakın bir şey: yaklaşık her 4 harf = 1 token. "Merhaba nasılsın" ≈ 5 token.

Hem gönderdiğiniz metin (input), hem de aldığınız cevap (output) token tüketir.

Fiyatlar Nasıl?

Fiyatlar genellikle "1 milyon token başına dolar" şeklinde gösterilir. Kulağa büyük geliyor ama aslında çok küçük miktarlar.

Ekonomik (mini/flash) sınıfı bir model için örnek:

Günlük 100 soru sorduğunuzu ve her soru-cevap çiftinin 500 token tuttuğunu varsayalım:

100 soru × 500 token = 50.000 token/gün
50.000 × 30 gün = 1.500.000 token/ay
Mini sınıfı modelle maliyet ≈ 1-2 dolar/ay

Evet, çoğu kişisel kullanım için aylık 1-5 dolar gibi bir miktardan bahsediyoruz.

Model Seçimi Maliyeti Doğrudan Etkiler

Tavsiye: Başlangıç için mini/flash sınıfı bir model kullanın. Çoğu iş için fazlasıyla yeterli, maliyeti çok düşük. Fiyatlar sık değişiyor — güncel rakamı her zaman sağlayıcının pricing sayfasından doğrulayın.

Ücretsiz Tier Var mı?

Bazı şirketler sınırlı ücretsiz kullanım sunar:

• Google Gemini API — Ücretsiz tier mevcut (hız sınırlı)
• Groq — Bazı açık kaynak modeller için ücretsiz tier
• OpenAI — Yeni hesaplara artık otomatik deneme kredisi verilmiyor; bakiye yükleyerek başlamanız gerekiyor
• OpenRouter — 25'ten fazla modelin ücretsiz varyantı; 10 dolar tek seferlik yüklemeyle günlük 1.000 ücretsiz istek hakkı. Detaylar OpenRouter rehberimizde

7. Riskler ve Dikkat Edilmesi Gerekenler

API kullanmak güçlü bir araçtır — ama birkaç önemli risk var.

🔑 API Anahtarı Güvenliği

API anahtarınız ele geçirilirse, başkası sizin hesabınızdan (ve paranızdan) API kullanabilir.

Yapmamanız gerekenler:

• Anahtarı sosyal medyada paylaşmayın
• GitHub'a yüklediğiniz kodlara anahtarı direkt yazmayın
• Ekran görüntüsü paylaşırken anahtarın görünmediğinden emin olun
• WhatsApp veya e-posta ile kimseyle göndermeyin

Yapmanız gerekenler:

• Anahtarı her zaman güvenli bir yerde saklayın (şifre yöneticisi: Bitwarden, 1Password)
• Mutlaka harcama limiti belirleyin
• Anahtarın sızdığını düşünüyorsanız hemen silin ve yeni oluşturun

💸 Beklenmedik Fatura Riski

Yanlış yazılmış bir döngü veya hatalı bir otomasyyon, kısa sürede binlerce istek gönderebilir. Bu faturanıza yansır.

Çözüm: OpenAI panelinden aylık harcama limiti belirleyin. Limit dolunca API otomatik durur.

🔒 Veri Gizliliği

API'ye gönderdiğiniz metinler model sağlayıcısının sunucularına gider. Kişisel veriler, sözleşmeler, şifreler gibi hassas bilgileri API'ye göndermeyin.

Eğer kurumsal kullanım yapıyorsanız, şirketinizin hangi veri gizliliği politikalarına uyması gerektiğini kontrol edin.

⚡ Rate Limit (İstek Sınırı)

Her API hizmetinin saniyede/dakikada kabul ettiği istek sayısı sınırlıdır. Çok hızlı çok istek gönderirseniz hata alırsınız.

Bu genellikle teknik bir sorun ama bilmeniz iyi: Yeni hesaplarda bu sınır daha düşüktür, zamanla artar.

8. Kod Bilmeden API Kullanabilir miyim?

Evet. Özellikle son iki yılda bu alan inanılmaz gelişti.

Seçenek 1 — No-Code / Low-Code Otomasyon Araçları

Bu araçlar API bağlantılarını görsel olarak yapmanızı sağlar:

• Make (eski Integromat) — Türkçe içerik de var, başlangıç için iyi
• n8n — Açık kaynak, kendi sunucunuzda çalıştırabilirsiniz
• Zapier — En yaygın, en kolay ama pahalı

Bu araçlarla "Gmail'den gelen her müşteri e-postasını GPT'ye özetle ve bana ilet" gibi otomasyonları tek satır kod yazmadan kurabilirsiniz.

Seçenek 2 — Vibe Coding Araçları

Cursor, Windsurf, Bolt.new veya Claude Code gibi araçlar, yapay zekaya ne yapmak istediğinizi söylemenizi ve kodun otomatik yazılmasını sağlar.

Bu araçların bazıları kendi API anahtarlarını kullanır ama kendi anahtarınızı bağlayarak daha fazla kontrol elde edebilirsiniz.

Bu araçlar sayesinde "ben kod bilmiyorum" artık bir engel değil. Yapay zekayla konuşarak uygulama geliştirmek gerçek.

Seçenek 3 — OpenAI Playground

Kod yazmadan API'yi test etmek için platform.openai.com/playground adresine gidin. Burası bir çeşit "API deneme sahası" — system prompt yazabilir, modeli seçebilir, test edebilirsiniz. Öğrenmek için mükemmel bir başlangıç noktası.

Seçenek 4 — OpenRouter: Tek API Anahtarıyla Her Model

OpenRouterⁱ300'den fazla modeli tek bir API endpoint'i üzerinden sunan aracı katman kullanımı giderek yaygınlaşıyor. OpenAI, Anthropic, Google, DeepSeek, Meta — hepsine tek bir API anahtarıyla erişebiliyorsunuz.

Neden tercih edilir? Her şirket için ayrı hesap açmak, ayrı bakiye yüklemek ve ayrı API anahtarı yönetmek yerine tek bir noktadan yönetim yapabiliyorsunuz. Bazı modeller OpenRouter üzerinden ücretsiz erişilebilir. OpenRouter adresinden başlayabilirsiniz; kurulumu, ücretsiz katmanı ve model seçimini adım adım OpenRouter rehberimizde anlattık.

Seçenek 5 — Hazır Entegrasyonlar

Pek çok uygulama zaten API entegrasyonu sunar:

• Notion AI — OpenAI API ile çalışır, kendi anahtarınızı bağlayabilirsiniz
• Obsidian eklentileri — Kendi API anahtarınızla çalışan yapay zeka eklentileri
• VS Code eklentileri — Kod editörünüzde yapay zeka

9. İlk Adımlar — Nereden Başlamalıyım?

Eğer hiç deneyiminiz yoksa şu sırayı öneririm:

Adım 1 — Önce Playground'da deneyin (ücretsiz değil ama çok ucuz)

1. platform.openai.com adresine gidin, kayıt olun
2. 5 dolar bakiye yükleyin, 20 dolar harcama limiti belirleyin
3. API anahtarı oluşturun
4. Playground'a gidin, mini sınıfı bir model seçin
5. System prompt yazın: "Sen yardımcı bir asistansın, Türkçe cevap ver"
6. Bir şeyler sorun, nasıl çalıştığını görün

Adım 2 — Make veya n8n ile basit bir otomasyon kurun

"Bir formu doldurunca GPT o veriyi işlesin ve e-posta göndersin" gibi basit bir şey. Make'in ücretsiz planıyla başlayabilirsiniz.

Adım 3 — İhtiyacınıza göre büyütün

Ne yapmak istediğinizi netleştirin. Otomasyon mu? Kendi chatbotunuz mu? Bir uygulama mı? Her biri için farklı araçlar ve yaklaşımlar var.

Özet: Bilmeniz Gereken 5 Şey

1. API = garson — Sizin talebinizi yapay zeka motoruna iletir, cevabı geri getirir
2. API anahtarı = şifre — Kimseyle paylaşmayın, mutlaka harcama limiti belirleyin
3. Ücret token bazlı — Çoğu kişisel kullanım için aylık 1-5 dolar yeterli
4. Kod bilmek zorunlu değil — Make, n8n, Playground ile başlayabilirsiniz
5. Başlangıçta mini/flash sınıfı bir model — Ucuz, hızlı, çoğu iş için fazlasıyla yeterli

🐙 mindi notu: API dünyası ilk bakışta teknik ve korkutucu görünüyor. Ama bugün milyonlarca kişi kod bilmeden API kullanıyor — otomasyon araçları sayesinde. En iyi öğrenme yolu denemektir: 5 dolar yükleyin, Playground'u açın, bir şeyler sorun. İlk "aha!" anından sonra her şey daha net görünmeye başlar.

📖 Terimler Sözlüğü

API (Application Programming Interface): İki yazılımın birbiriyle iletişim kurmasını sağlayan arayüz. Yapay zeka API'si, dil modellerini kendi uygulamanızda kullanmanızı sağlar.

API Anahtarı (API Key): Sisteme kim olduğunuzu kanıtlayan özel şifre. sk-proj-... gibi uzun bir karakter dizisidir.

Token: Yapay zeka modellerinin metni işleme birimi. Yaklaşık her 4 harf = 1 token. Hem giriş hem çıkış token tüketir.

Model: Kullandığınız yapay zeka motoru. GPT-5.5, Claude Sonnet 5, Gemini 3 Flash gibi. Her birinin farklı özellikleri ve fiyatları var.

Rate Limit: API'nin belirli bir sürede kabul ettiği maksimum istek sayısı. Aşıldığında hata döner.

Spending Limit (Harcama Limiti): API panelinden belirlediğiniz aylık maksimum harcama. Limit dolunca API otomatik durur.

Playground: OpenAI'nin API'yi kod yazmadan test etmenizi sağladığı web arayüzü.

System Prompt: Yapay zekaya kalıcı olarak verdiğiniz talimat. "Her zaman Türkçe cevap ver" veya "Sen bir müşteri hizmetleri asistanısın" gibi.

No-Code / Low-Code: Kod yazmadan uygulama geliştirme veya otomasyon kurma yaklaşımı. Make, n8n, Zapier bu kategoridedir.

Vibe Coding: Yapay zekaya ne yapmak istediğinizi söyleyerek (kod yazmadan) uygulama geliştirme yöntemi. Cursor, Windsurf, Claude Code bu kategoridedir.

OpenRouter: 300'den fazla AI modelini tek bir API anahtarıyla kullanmanızı sağlayan aracı servis. Farklı sağlayıcılar arasında kolayca geçiş yapabilirsiniz.