Hızlı Başlangıç
LyDian API'yi kullanmaya başlamak için öncelikle bir API anahtarına ihtiyacınız var. Dashboard'dan API anahtarınızı oluşturabilir ve hemen kullanmaya başlayabilirsiniz.
Authentication
Tüm API istekleri Authorization header ile API key gerektir. API anahtarınızı Bearer token olarak gönderin.
HTTP Header
Authorization: Bearer YOUR_API_KEY
Base URL
Tüm API endpoint'leri için base URL. Production ortamında her zaman HTTPS kullanın.
https://api.lydian.ai/v1
Chat Completion
LyDian AI modelleri ile sohbet edebileceğiniz ana endpoint. Streaming ve non-streaming modlarını destekler. Gerçek zamanlı yanıtlar için streaming kullanın.
/chat/completions
Sohbet tamamlama endpoint'i ile AI modellerine sorular sorun, kod yazın, içerik oluşturun ve daha fazlasını yapın.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
modelRequired |
string | Model ID (örn: "lydian-turbo", "lydian-pro") |
messagesRequired |
array | Sohbet mesajları dizisi (role, content) |
temperatureOptional |
number | 0 ile 2 arası (varsayılan: 0.7) - Yaratıcılık seviyesi |
max_tokensOptional |
integer | Maksimum token sayısı (varsayılan: 2000) |
streamOptional |
boolean | Streaming modu (varsayılan: false) |
Example Request
const response = await fetch('https://api.lydian.ai/v1/chat/completions', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-lydian-...',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'lydian-turbo',
messages: [
{ role: 'user', content: 'Merhaba! AI ile neler yapabilirim?' }
],
temperature: 0.7,
max_tokens: 2000
})
});
const data = await response.json();
console.log(data.choices[0].message.content);
import requests
url = "https://api.lydian.ai/v1/chat/completions"
headers = {
"Authorization": "Bearer sk-lydian-...",
"Content-Type": "application/json"
}
data = {
"model": "lydian-turbo",
"messages": [
{"role": "user", "content": "Merhaba! AI ile neler yapabilirim?"}
],
"temperature": 0.7,
"max_tokens": 2000
}
response = requests.post(url, json=data, headers=headers)
print(response.json()["choices"][0]["message"]["content"])
curl https://api.lydian.ai/v1/chat/completions \
-H "Authorization: Bearer sk-lydian-..." \
-H "Content-Type: application/json" \
-d '{
"model": "lydian-turbo",
"messages": [
{"role": "user", "content": "Merhaba! AI ile neler yapabilirim?"}
],
"temperature": 0.7,
"max_tokens": 2000
}'
Example Response
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1677858242,
"model": "lydian-turbo",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Merhaba! AI ile pek çok şey yapabilirsiniz..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 145,
"total_tokens": 157
}
}
Image Generation
Metin açıklamalarından yüksek kaliteli görseller oluşturun. DALL-E, Stable Diffusion ve diğer görsel üretim modelleri ile desteklenir.
/images/generate
Görsel üretim endpoint'i ile metin açıklamalarından profesyonel kalitede görseller oluşturun. Farklı boyut ve kalite seçenekleri mevcuttur.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
promptRequired |
string | Görsel açıklaması (max 1000 karakter) |
sizeOptional |
string | "1024x1024", "1792x1024", "1024x1792" (varsayılan: "1024x1024") |
nOptional |
integer | Oluşturulacak görsel sayısı: 1-4 (varsayılan: 1) |
qualityOptional |
string | "standard" veya "hd" (varsayılan: "standard") |
Example Request
curl https://api.lydian.ai/v1/images/generate \
-H "Authorization: Bearer sk-lydian-..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "Futuristic city with flying cars at sunset",
"size": "1024x1024",
"n": 1,
"quality": "hd"
}'
Available Models
LyDian platformunda kullanılabilir tüm AI modelleri. Her model farklı yetenekler ve fiyatlandırma ile gelir.
/models
Kullanılabilir tüm AI modellerini listeler. Her modelin yetenekleri, context window boyutu ve fiyatlandırma bilgilerini içerir.
Popular Models
Error Codes
API standart HTTP status kodları kullanır. Tüm hata yanıtları JSON formatında detaylı hata bilgisi içerir.
Status Codes
| Code | Status | Description |
|---|---|---|
200 |
OK | İstek başarılı |
400 |
Bad Request | İstek geçersiz veya eksik parametreler içeriyor |
401 |
Unauthorized | API anahtarı geçersiz veya eksik |
403 |
Forbidden | API anahtarı geçerli ancak yetkisiz |
404 |
Not Found | İstenen kaynak bulunamadı |
429 |
Rate Limit Exceeded | Çok fazla istek gönderildi |
500 |
Internal Server Error | Sunucu hatası |
503 |
Service Unavailable | Hizmet geçici olarak kullanılamıyor |
Error Response Format
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}
Rate Limits
API rate limit'leri, dakika ve saat bazında uygulanır. Limit aşıldığında 429 status kodu döner. Her response'da rate limit bilgileri header'larda bulunur.
Default Limits
| Plan | Requests/Min | Requests/Hour | Tokens/Min |
|---|---|---|---|
| Free | 3 | 100 | 50,000 |
| Pro | 60 | 3,000 | 500,000 |
| Enterprise | Custom | Custom | Custom |
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset