Yapay zekâ API

Tanım

Yapay zekâ API, bir AI servisine programatik erişim. HTTP üzerinden istek/cevap; kendi ürününden çağırarak AI yeteneklerini ekleyebilirsin.

İki yaygın senaryo:

1. Doğrudan model API’sı — OpenAI, Anthropic, Google. LLM’e prompt at, cevap al.
2. Agent runtime API’sı — Ilura api.ilura.com.tr. Yetiştirilmiş agent’a sor, kararı al.

İkisi farklı katman; karıştırılmamalı.

Doğrudan model API örneği

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Şu PDF'ten tarih çıkar..."}]
  }'

Stateless. Her çağrı bağımsız. Bellek yok, kişilik yok — sadece model.

Ilura agent API örneği

curl https://api.ilura.com.tr/v1/agents/naci/chat \
  -H "Authorization: Bearer $ILURA_AGENT_KEY" \
  -d '{"message": "2024/45821 dosyasında durum ne?"}'

Stateful. Naci’nin belleği + Bayesian profil + sektörel uzmanlığı arka planda; cevap senin gibi yetişmiş agent’tan geliyor.

API key güvenliği

Üç temel kural:

1. Anahtarı sunucuda tut — istemci JS’e asla gömme
2. Env variable — .env dosyasında, repo’ya commit etme
3. Rotasyon — sızıntı şüphesinde anında yenile

Detay: API anahtarı sayfası.

Yaygın yanılgılar

“AI API = ChatGPT API.” — ChatGPT bir ürün; OpenAI API ondan farklı (API doğrudan modele).

“Agent API = LLM API.” — Yanlış. LLM API stateless model çağrısı; agent API yetişmiş kişilik + bellek + audit ile çağrı.

“API çağrısı = sınırsız.” — Tüm API’lerin rate limit’i var. Ilura agent API kullanıcı planına göre limit uygular.