API Referansı

LyDian Enterprise AI platformu için kapsamlı API dokümantasyonu. Tüm uç noktalar, parametreler ve örnek kullanım.

Kimlik Doğrulama

Tüm API istekleri Bearer token kimlik doğrulaması gerektirir. Token'ınızı authorization başlığında kullanın.

curl -X GET https://www.ailydian.com/api/models \
  -H "Authorization: Bearer sk-lydian-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Güvenlik Notları

API anahtarınızı asla herkese açık depolarda paylaşmayın
Ortam değişkenlerinde saklayın
İstemci tarafı kodunda kullanmayın
Anahtarlarınızı düzenli olarak yenileyin

post /api/chat

AI modelleriyle bir sohbet oluşturur. 23 farklı modelden seçim yapabilirsiniz.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
message	string	Evet	Kullanıcı mesajı
model	string	Hayır	Kullanılacak model (varsayılan: LyDian Engine)
stream	boolean	Hayır	Akış modu (varsayılan: false)
temperature	number	Hayır	0-1 aralığı, yaratıcılık seviyesi

Örnek İstek

const response = await fetch('https://www.ailydian.com/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'yapay zeka nedir?',
    model: 'LyDian Engine',
    temperature: 0.7
  })
});

const data = await response.json();
// DEBUG: console.log(data.response);

Örnek Yanıt

{
  "success": true,
  "response": "yapay zeka, makinelerin insan benzeri...",
  "model": "LyDian Engine",
  "tokens": 156,
  "timestamp": "2024-01-15T10:30:00Z"
}

post /api/chat

Gerçek zamanlı akış ile yanıt alın. Her token geldikçe anında görüntülenir.

Örnek İstek (Akış)

const response = await fetch('https://www.ailydian.com/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'uzun bir makale yaz',
    stream: true
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value);
  process.stdout.write(chunk); // write as each word arrives
}

get /api/models

Kullanılabilir tüm AI modellerini listeler. Her modelin özelliklerini ve sınırlarını gösterir.

Örnek İstek

curl -X GET https://www.ailydian.com/api/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

{
  "models": [
    {
      "id": "LyDian Engine",
      "name": "LyDian Engine Omni",
      "provider": "lydian-labs",
      "capabilities": ["chat", "vision", "code"],
      "max_tokens": 128000
    },
    {
      "id": "enterprise-ai-3.5",
      "name": "Ultra Intelligence Model",
      "provider": "advanced-ai-platform",
      "capabilities": ["chat", "code", "analysis"],
      "max_tokens": 200000
    }
  ]
}

post /api/vision

Görüntü analizi yapar. Nesne algılama, yüz tanıma, OCR ve içerik moderasyonu.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
image	string	Evet	base64 kodlu görüntü veya URL
task	string	Evet	detect, ocr, moderate, describe

Örnek İstek

const response = await fetch('https://www.ailydian.com/api/vision', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    image: 'https://example.com/image.jpg',
    task: 'describe'
  })
});

const data = await response.json();

post /api/generate-image

Metin açıklamasından yüksek kaliteli görseller üretir. LyDian Image Engine modelini kullanır.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
prompt	string	Evet	Görsel açıklaması
size	string	Hayır	1024x1024, 1792x1024, 1024x1792
quality	string	Hayır	standard, hd

Örnek İstek

const response = await fetch('https://www.ailydian.com/api/generate-image', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'a minimalist mountain landscape at sunset',
    size: '1024x1024',
    quality: 'hd'
  })
});

post /api/translate

84 dil desteği ile metin çevirisi. z.ai dil paketini kullanır.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
text	string	Evet	Çevrilecek metin
from	string	Hayır	Kaynak dil (otomatik algılama)
to	string	Evet	Hedef dil kodu

Örnek İstek

const response = await fetch('https://www.ailydian.com/api/translate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'hello world',
    to: 'tr'
  })
});

Hata Kodları

Kod	Durum	Açıklama
400	Hatalı İstek	Geçersiz istek formatı veya parametreler
401	Yetkisiz	Geçersiz veya eksik API anahtarı
403	Yasak	Bu kaynağa erişim izniniz yok
429	Hız Sınırı	Çok fazla istek, daha sonra tekrar deneyin
500	Sunucu Hatası	Sunucu hatası, destek ekibiyle iletişime geçin

Hız Sınırlama

API istekleriniz plan türünüze göre sınırlandırılır.

Plan	İstek/Dakika	İstek/Gün	Token Limiti
free	10	100	10k tokens
starter	60	10,000	100k tokens
pro	300	100,000	1M tokens
enterprise	Sınırsız	Sınırsız	Sınırsız