Schnellstart
Um die LyDian API zu nutzen, benötigen Sie zunächst einen API-Schlüssel. Sie können Ihren API-Schlüssel im Dashboard erstellen und sofort verwenden.
Authentifizierung
Alle API-Anfragen erfordern einen API-SchlĂĽssel im Authorization-Header. Senden Sie Ihren API-SchlĂĽssel als Bearer-Token.
HTTP-Header
Authorization: Bearer YOUR_API_KEY
Basis-URL
Basis-URL fĂĽr alle API-Endpunkte. Verwenden Sie in der Produktionsumgebung immer HTTPS.
https://api.ailydian.com/v1
Chat-Vervollständigung
Haupt-Endpunkt fĂĽr das Chatten mit LyDian-KI-Modellen. Streaming- und Nicht-Streaming-Modi. Verwenden Sie Streaming fĂĽr Echtzeit-Antworten.
/chat/completions
Stellen Sie KI-Modellen über den Chat-Vervollständigungs-Endpunkt Fragen, schreiben Sie Code, erstellen Sie Inhalte und mehr.
Anfrageparameter
| Parameter | Typ | Beschreibung |
|---|---|---|
modelErforderlich
|
string | Modell-ID (z. B.: "lydian-turbo", "lydian-pro") |
messagesErforderlich
|
array | Array von Chat-Nachrichten (role, content) |
temperatureOptional
|
number | 0 bis 2 (Standard: 0.7) - Kreativitätsstufe |
max_tokensOptional
|
integer | Maximale Anzahl von Tokens (Standard: 2000) |
streamOptional
|
boolean | Streaming-Modus (Standard: false) |
Beispielanfrage
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 }'
Beispielantwort
{ "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 } }
Bildgenerierung
Erstellen Sie mit LyDian Image Engine und anderen Bildgenerierungsmodellen hochwertige Bilder aus Textbeschreibungen.
/images/generate
Erstellen Sie mit dem Bildgenerierungs-Endpunkt Bilder in professioneller Qualität aus Textbeschreibungen. Verschiedene Größen- und Qualitätsoptionen verfügbar.
Anfrageparameter
| Parameter | Typ | Beschreibung |
|---|---|---|
promptErforderlich
|
string | Bildbeschreibung (max. 1000 Zeichen) |
sizeOptional
|
string | "1024x1024", "1792x1024", "1024x1792" (Standard: "1024x1024") |
nOptional
|
integer | Anzahl der zu generierenden Bilder: 1-4 (Standard: 1) |
qualityOptional
|
string | "standard" oder "hd" (Standard: "standard") |
Beispielanfrage
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" }'
VerfĂĽgbare Modelle
Alle auf der LyDian-Plattform verfügbaren KI-Modelle. Jedes Modell verfügt über unterschiedliche Fähigkeiten und Preise.
/models
Listet alle verfügbaren KI-Modelle auf. Fähigkeiten jedes Modells, Größe des Kontextfensters und Preisinformationen.
Beliebte Modelle
Fehlercodes
Die API verwendet standardmäßige HTTP-Statuscodes. Alle Fehlerantworten enthalten detaillierte Fehlerinformationen im JSON-Format.
Statuscodes
| Code | Status | Description |
|---|---|---|
200 |
OK | Anfrage erfolgreich |
400 |
Bad Request | Anfrage ungültig oder enthält fehlende Parameter |
401 |
Unauthorized | API-SchlĂĽssel ungĂĽltig oder fehlt |
403 |
Forbidden | API-SchlĂĽssel gĂĽltig, aber nicht autorisiert |
404 |
Not Found | Angeforderte Ressource nicht gefunden |
429 |
Rate Limit Exceeded | Zu viele Anfragen gesendet |
500 |
Internal Server Error | Serverfehler |
503 |
Service Unavailable | Dienst vorĂĽbergehend nicht verfĂĽgbar |
Format der Fehlerantwort
{ "error": {
"message":
"Invalid API key provided",
"type":
"invalid_request_error",
"code":
"invalid_api_key" } }
Ratenbegrenzungen
API-Ratenbegrenzungen werden auf Minuten- und Stundenbasis angewendet. Bei Überschreitung der Limits wird ein Statuscode 429 zurückgegeben. Jede Antwort enthält Header mit Ihren Ratenbegrenzungsinformationen.
Standardlimits
| Plan | Anfragen/Min | Anfragen/Std | 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