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

İç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

Bir restorana gittiğini düşün. Mutfağa geçip kendi yemeğini pişiremezsin — garsona söylersin, garson mutfağa iletir, mutfak pişirir, garson yemeği sana getirir.

API tam olarak o garsondur.

Sen bir istek gönderirsin → API bu isteği ilgili sisteme iletir → sistem işler → API cevabı sana 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şine yaramaz. Asıl önemli olan şu:

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

Örnek: Hava durumu uygulamaları kendi uydu ağını işletmez; meteoroloji servislerinin API'siyle konuşur. Birçok mobil uygulama da harita verisini kendisi üretmez, 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 uygulamana, aracına veya iş akışına entegre etmeni sağlayan bir hizmettir.

Yani şöyle düşün:

• ChatGPT web sitesi → OpenAI'nin hazırladığı, herkese açık arayüz. Yazarsın, cevap alırsın. Bitti.
• OpenAI API → Aynı yapay zeka motoru, ama bu sefer senin programın, aracın veya otomasyonun üzerinden çalışır.

Fark ne? Web sitesinde sadece sen kullanırsın, sadece elle yazarsın. API ile ise:

• Kendi uygulamana yapay zeka ekleyebilirsin
• Binlerce soruyu otomatik olarak işletebilirsin
• Başka araçlarla (n8n, Make, Excel, Google Sheets gibi) entegre edebilirsin
• Kendi özel sistem talimatlarını kalıcı olarak uygulayabilirsin

3. Neden API Kullanmak İsteyeyim?

Birkaç gerçek hayat senaryosu:

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

Senaryo 2 — Müşteri hizmetleri
Sık sorulan sorulara otomatik yanıt veren bir chatbot kuruyorsun. Kullanıcı sitene gelip soru soruyor, yapay zeka cevaplıyor. Sen uyurken bile çalışıyor.

Senaryo 3 — İçerik üreticisi
Her gün 10 farklı sosyal medya gönderisi üretmen gerekiyor. API ile otomatik olarak çeşitli içerikler ürettiriyorsun, sen sadece seçip yayınlıyorsun.

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

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

4. Hangi Şirketlerin API'si Var?

Büyük oyuncular şunlar:

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

Yeni başlıyorsan OpenAI API ile başla. 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ına göre diğerlerine geçebilir veya birden fazlasını kullanabilirsin. Modelleri yan yana karşılaştırmak istersen Yapay Zeka Modelleri Karşılaştırması sayfasına bakabilirsin. "Hepsini denemeden karar veremem" diyorsan üçüncü bir yol da var: Ücretsiz Yapay Zeka API'si mi Lazım? OpenRouter Rehberi — tek anahtarla 450'den fazla modele erişim.

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

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

Banka kartı şifren gibi düşün — kimseyle paylaşma, ekran görüntüsüne koyma.

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

1. Adım — Hesap oluştur

platform.openai.com adresine git ve kayıt ol. E-posta ve telefon numarası gerekiyor.

2. Adım — Bakiye yükle

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

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

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

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

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

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

4. Adım — Anahtarı kullanmaya başla

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

6. Ücretler Nasıl İşliyor?

Bu kısmı iyi anla — API kullanımı bedava değildir ama düşündüğünden ç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ğin metin (input), hem aldığın cevap (output) token tüketir.

Fiyatlar Nasıl?

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

En ekonomik modellerden biri olan GPT-6 Luna için 1 milyon token başına:

Günde 100 soru sorduğunu 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
GPT-6 Luna ile maliyet ≈ 0,50 dolar/ay

Evet, çoğu kişisel kullanımda konuştuğumuz rakam aylık birkaç doların altında.

Model Seçimi Maliyeti Doğrudan Etkiler

Tavsiye: Başlangıç için mini/flash sınıfı bir model kullan. Ç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ğrula.

[mindi_yorum]
💰 En ucuz modeller 1 milyon token başına 10 sente kadar indi — GPT-6 Luna girdi tarafında 0,10 dolar.
🟢 Kişisel kullanımda aylık fatura çoğu zaman 1 doların altında kalıyor.
🟡 Ama "ucuz model yeter" diye başlayıp haberin olmadan en pahalı modele geçmek kolay; harcama limiti belirlemeden bırakma.
🔵 Her zaman mini/flash sınıfıyla başla, iş karmaşıklaşınca modeli yükselt — ters yönde fatura şoku yersin.

Ücretsiz Tier Var mı?

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

• Google Gemini API — Ücretsiz tier mevcut; Flash modellerde kredi kartı istemez, hız sınırlıdır
• Groq — Açık kaynak modeller için ücretsiz plan (dakika/gün başına istek limitli)
• OpenAI — Yeni hesaplara artık otomatik deneme kredisi verilmiyor; bakiye yükleyerek başlaman gerekiyor
• OpenRouter — 20'den 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 ele geçirilirse, başkası senin hesabından (ve parandan) API kullanabilir.

Yapmaman gerekenler:

• Anahtarı sosyal medyada paylaşma
• GitHub'a yüklediğin kodlara anahtarı doğrudan yazma
• Ekran görüntüsü paylaşırken anahtarın görünmediğinden emin ol
• WhatsApp veya e-posta ile kimseye gönderme

Yapman gerekenler:

• Anahtarı her zaman güvenli bir yerde sakla (şifre yöneticisi: Bitwarden veya 1Password)
• Mutlaka harcama limiti belirle
• Anahtarın sızdığını düşünüyorsan hemen sil ve yeni oluştur

💸 Beklenmedik Fatura Riski

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

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

🔒 Veri Gizliliği

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

Kurumsal kullanım yapıyorsan, şirketinin hangi veri gizliliği politikalarına uyması gerektiğini kontrol et.

⚡ 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önderirsen hata alırsın.

Bu genellikle teknik bir sorun ama bilmen 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ı sağlar:

• Make (eski adıyla Integromat) — Türkçe içerik de var, başlangıç için iyi
• n8n — Açık kaynak, kendi sunucunda çalıştırabilirsin
• Zapier — En yaygın ve 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 kurabilirsin.

Seçenek 2 — Vibe Coding Araçları

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

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

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 git. Burası bir çeşit "API deneme sahası" — system prompt yazabilir, modeli seçebilir, test edebilirsin. Öğrenmek için iyi bir başlangıç noktası.

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

OpenRouterⁱ450'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şebilirsin.

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 yaparsın. Bazı modeller OpenRouter üzerinden ücretsiz erişilebilir. OpenRouter sayfasından başlayabilirsin; 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ı bağlayabilirsin
• Obsidian eklentileri — Kendi API anahtarınla çalışan yapay zeka eklentileri
• VS Code eklentileri — Kod editöründe yapay zeka

[mindi_yorum]
🟢 Kod bilmeden API kullanmanın en pratik yolu otomasyon araçları: Make ve n8n ile bağlantıları görsel olarak kuruyorsun.
🟡 No-code araçların ücretsiz planları istek sayısıyla sınırlı; yoğun kullanımda ücretli plana geçmen gerekir.
🔵 Kendi API anahtarını bağlayabilen araçları seç — hem maliyeti kontrol edersin hem model seçimi sende kalır.

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

Hiç deneyimin yoksa şu sırayı öneririm:

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

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

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

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

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

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

Özet: Bilmen Gereken 5 Şey

1. API = garson — İsteğini yapay zeka motoruna iletir, cevabı geri getirir
2. API anahtarı = şifre — Kimseyle paylaşma, mutlaka harcama limiti belirle
3. Ücret token bazlı — Çoğu kişisel kullanım için aylık birkaç dolar yeterli
4. Kod bilmek zorunlu değil — Make, n8n, Playground ile başlayabilirsin
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 denemek: 5 dolar yükle, Playground'u aç, bir şeyler sor. İlk "aha!" anından sonra her şey daha net görünmeye başlıyor.

📖 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 uygulamanda kullanmanı sağlar.

API Anahtarı (API Key): Sisteme kim olduğunu 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 yapay zeka motoru. GPT-6 Astra, Claude Opus 5.5, Gemini 3.8 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ğin aylık maksimum harcama. Limit dolunca API otomatik durur.

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

System Prompt: Yapay zekaya kalıcı olarak verdiğin 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ğini söyleyerek (kod yazmadan) uygulama geliştirme yöntemi. Cursor, Windsurf, Claude Code bu kategoridedir.

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