API-Referenz

Umfassende API-Dokumentation fĂĽr die LyDian Enterprise AI-Plattform. Alle Endpunkte, Parameter und Beispielverwendung.

Basis-URL
https://www.ailydian.com/api
Alle API-Anfragen beginnen mit dieser Basis-URL. Verwenden Sie in der Produktionsumgebung Ihre eigene Domain.
Schnellstart
Die LyDian API verwendet eine RESTful-Architektur. Alle Anfragen erfolgen im JSON-Format. Jede Anfrage erfordert eine Authentifizierung mit einem Authorization-Header.

Authentifizierung

Alle API-Anfragen erfordern eine Bearer-Token-Authentifizierung. Verwenden Sie Ihr Token im Authorization-Header. 

curl -X GET https://www.ailydian.com/api/models \
  -H "Authorization: Bearer sk-lydian-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"
Sicherheitshinweise
  • Teilen Sie Ihren API-SchlĂĽssel niemals in öffentlichen Repositories
  • In Umgebungsvariablen speichern
  • Nicht im clientseitigen Code verwenden
  • Erneuern Sie Ihre SchlĂĽssel regelmäßig
post /api/chat

Erstellt einen Chat mit AI-Modellen. Sie können aus 23 verschiedenen Modellen wählen.

Parameter
Parameter Typ Erforderlich Beschreibung
message string Ja Benutzernachricht
model string Nein Zu verwendendes Modell (Standard: LyDian Engine)
stream boolean Nein Streaming-Modus (Standard: false)
temperature number Nein Bereich 0-1, Kreativitätsstufe
Beispielanfrage
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);
Beispielantwort
{
  "success": true,
  "response": "yapay zeka, makinelerin insan benzeri...",
  "model": "LyDian Engine",
  "tokens": 156,
  "timestamp": "2024-01-15T10:30:00Z"
}
post /api/chat

Erhalten Sie Antworten mit Echtzeit-Streaming. Wird sofort angezeigt, sobald jedes Token eintrifft.

Beispielanfrage (Streaming) 
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

Listet alle verfĂĽgbaren AI-Modelle auf. Zeigt die Funktionen und Grenzen jedes Modells.

Beispielanfrage
curl -X GET https://www.ailydian.com/api/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Beispielantwort
{
  "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

FĂĽhrt eine Bildanalyse durch. Objekterkennung, Gesichtserkennung, OCR und Inhaltsmoderation.

Parameter
Parameter Typ Erforderlich Beschreibung
image string Ja base64-kodiertes Bild oder URL
task string Ja detect, ocr, moderate, describe
Beispielanfrage
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

Erzeugt hochwertige Bilder aus einer Textbeschreibung. Verwendet das Modell LyDian Image Engine.

Parameter
Parameter Typ Erforderlich Beschreibung
prompt string Ja Bildbeschreibung
size string Nein 1024x1024, 1792x1024, 1024x1792
quality string Nein standard, hd
Beispielanfrage
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

TextĂĽbersetzung mit UnterstĂĽtzung fĂĽr 84 Sprachen. Verwendet das z.ai-Sprachpaket.

Parameter
Parameter Typ Erforderlich Beschreibung
text string Ja Zu ĂĽbersetzender Text
from string Nein Quellsprache (automatische Erkennung)
to string Ja Zielsprachcode
Beispielanfrage
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'
  })
});

Fehlercodes

Code Status Beschreibung
400 UngĂĽltige Anfrage UngĂĽltiges Anfrageformat oder ungĂĽltige Parameter
401 Nicht autorisiert UngĂĽltiger oder fehlender API-SchlĂĽssel
403 Verboten Sie haben keine Berechtigung, auf diese Ressource zuzugreifen
429 Ratenlimit Zu viele Anfragen, versuchen Sie es später erneut
500 Serverfehler Serverfehler, kontaktieren Sie das Support-Team

Ratenbegrenzung

Ihre API-Anfragen sind je nach Plantyp begrenzt.

Plan Anfragen/Minute Anfragen/Tag Token-Limit
free 10 100 10k tokens
starter 60 10,000 100k tokens
pro 300 100,000 1M tokens
enterprise Unbegrenzt Unbegrenzt Unbegrenzt