Hızlı Başlangıç
LyDian API'yi kullanmaya başlamak için önce bir API anahtarına ihtiyacınız var. API anahtarınızı kontrol panelinden oluşturup hemen kullanmaya başlayabilirsiniz.
Kimlik Doğrulama
Tüm API istekleri Authorization başlığında bir API anahtarı gerektirir. API anahtarınızı Bearer token olarak gönderin.
HTTP Başlığı
Authorization: Bearer YOUR_API_KEY
Temel URL
Tüm API uç noktaları için temel URL. Üretim ortamında her zaman HTTPS kullanın.
https://api.ailydian.com/v1
Sohbet Tamamlama
LyDian AI modelleriyle sohbet etmek için ana uç nokta. Akış (streaming) ve akışsız modlar. Gerçek zamanlı yanıtlar için akış modunu kullanın.
/chat/completions
Sohbet tamamlama uç noktası ile yapay zeka modellerine soru sorun, kod yazın, içerik oluşturun ve daha fazlasını yapın.
İstek Parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
modelZorunlu
|
string | Model kimliği (örn: "lydian-turbo", "lydian-pro") |
messagesZorunlu
|
array | Sohbet mesajları dizisi (role, content) |
temperatureİsteğe Bağlı
|
number | 0 ile 2 arası (varsayılan: 0.7) - Yaratıcılık seviyesi |
max_tokensİsteğe Bağlı
|
integer | Maksimum token sayısı (varsayılan: 2000) |
streamİsteğe Bağlı
|
boolean | Akış modu (varsayılan: false) |
Örnek İstek
const response =
await
fetch('https://api.ailydian.com/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.ailydian.com/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.ailydian.com/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 }'
Örnek Yanıt
{ "id":
"chatcmpl-abc123",
"object":
"chat.completion",
"created":
1677858242,
"model":
"lydian-turbo",
"choices": [ {
"index": 0,
"message": { "role":
"assistant",
"content":
"Hello! You can do many things with AI..."
},
"finish_reason":
"stop"
} ],
"usage": {
"prompt_tokens":
12,
"completion_tokens":
145,
"total_tokens":
157 } }
Görsel Üretimi
LyDian Image Engine ve diğer görsel üretim modelleriyle metin açıklamalarından yüksek kaliteli görseller oluşturun.
/images/generate
Görsel üretim uç noktası ile metin açıklamalarından profesyonel kalitede görseller oluşturun. Farklı boyut ve kalite seçenekleri mevcuttur.
İstek Parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
promptZorunlu
|
string | Görsel açıklaması (en fazla 1000 karakter) |
sizeİsteğe Bağlı
|
string | "1024x1024", "1792x1024", "1024x1792" (varsayılan: "1024x1024") |
nİsteğe Bağlı
|
integer | Üretilecek görsel sayısı: 1-4 (varsayılan: 1) |
qualityİsteğe Bağlı
|
string | "standard" veya "hd" (varsayılan: "standard") |
Örnek İstek
curl https://api.ailydian.com/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" }'
Mevcut Modeller
LyDian platformunda mevcut tüm yapay zeka modelleri. Her model farklı yetenekler ve fiyatlandırma ile gelir.
/models
Mevcut tüm yapay zeka modellerini listeler. Her modelin yetenekleri, bağlam penceresi boyutu ve fiyatlandırma bilgileri.
Popüler Modeller
Hata Kodları
API standart HTTP durum kodlarını kullanır. Tüm hata yanıtları JSON formatında ayrıntılı hata bilgisi içerir.
Durum Kodları
| 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 |
Hata Yanıtı Formatı
{ "error": {
"message":
"Invalid API key provided",
"type":
"invalid_request_error",
"code":
"invalid_api_key" } }
Hız Limitleri
API hız limitleri dakikalık ve saatlik bazda uygulanır. Limitler aşıldığında 429 durum kodu döndürülür. Her yanıt, hız limiti bilgilerinizi içeren başlıklar içerir.
Varsayılan Limitler
| Plan | İstek/Dakika | İstek/Saat | Token/Dakika |
|---|---|---|---|
| Free | 3 | 100 | 50,000 |
| Pro | 60 | 3,000 | 500,000 |
| Enterprise | Custom | Custom | Custom |
X-RateLimit-Limit, X-RateLimit-Remaining,
X-RateLimit-Reset