Zum Hauptinhalt springen

​
Übersicht

Die LemonData API ist OpenAI-kompatibel, was bedeutet, dass Sie das offizielle OpenAI SDK mit nur einer Änderung der Basis-URL verwenden können. Für die meisten Integrationen beginnen Sie mit POST /v1/chat/completions. Wir unterstützen außerdem native Anthropic- und Gemini-Anfrageformate sowie POST /v1/responses als optionalen erweiterten Pfad.

​
Basis-URL

https://api.lemondata.cc

​
Authentifizierung

Alle API-Endpunkte erfordern eine Authentifizierung mit einem Bearer-Token: 
Authorization: Bearer sk-your-api-key
Holen Sie Ihren API-Schlüssel vom Dashboard.
Zum interaktiven Playground: Der Playground auf dieser Dokumentationsseite dient nur zu Demonstrationszwecken und unterstützt das Eingeben von API-Schlüsseln nicht. Um die API zu testen, verwenden Sie bitte:
  • cURL - Kopieren Sie die Beispielbefehle und ersetzen Sie sk-your-api-key durch Ihren tatsächlichen Schlüssel
  • Postman - Importieren Sie unsere OpenAPI spec
  • SDK - Verwenden Sie das OpenAI/Anthropic SDK mit unserer Basis-URL

​
Unterstützte Endpunkte

​
Chat & Textgenerierung

EndpointMethodBeschreibung
/v1/chat/completionsPOSTOpenAI-kompatible Chat-Completions
/v1/messagesPOSTAnthropic-kompatible Messages-API
/v1/responsesPOSTOpenAI Responses API

​
Embeddings & Rerank

EndpointMethodBeschreibung
/v1/embeddingsPOSTText-Embeddings erstellen
/v1/rerankPOSTDokumente neu bewerten (Rerank)

​
Bilder

EndpointMethodBeschreibung
/v1/images/generationsPOSTBilder aus Text generieren
/v1/images/editsPOSTBilder bearbeiten
/v1/images/generations/{id}GETStatuspfad für Bildaufgaben bei aufgabenbasierten Bildantworten
Einige Bildmodelle können Ergebnisse inline zurückgeben, einige liefern aufgabenbasierte Antworten, und einige verhalten sich je nach geroutetem Anbieter-Pfad unterschiedlich. Wenn die Create-Antwort poll_url enthält, folgen Sie dieser exakt.

​
Audio

EndpointMethodBeschreibung
/v1/audio/speechPOSTText-to-Speech (TTS)
/v1/audio/transcriptionsPOSTSpeech-to-Text (STT)

​
Video

EndpointMethodBeschreibung
/v1/videos/generationsPOSTVideo-Generierungsaufgabe erstellen
/v1/tasks/{id}GETStatus asynchroner Aufgaben für Video-Jobs abrufen
/v1/videos/generations/{id}GETAbwärtskompatibler Statuspfad für Videoaufgaben
Für neue Clients bevorzugen Sie /v1/tasks/{id} und folgen Sie der von Create-Antworten zurückgegebenen poll_url. Behalten Sie /v1/videos/generations/{id} nur aus Gründen der Rückwärtskompatibilität.

​
Asynchrone Aufgaben

EndpointMethodBeschreibung
/v1/tasks/{id}GETVereinheitlichter Endpunkt für den Status asynchroner Aufgaben. Empfohlen, wenn Sie einem zurückgegebenen poll_url folgen
Dieser Endpunkt ist nicht auf Video, Musik und 3D beschränkt. Einige Bildaufgaben können ebenfalls /v1/tasks/{id} als kanonischen Polling-Pfad verwenden.

​
Musik

EndpointMethodBeschreibung
/v1/music/generationsPOSTMusik-Generierungsaufgabe erstellen
/v1/music/generations/{id}GETMusik-spezifischer Statuspfad
Für neue Clients bevorzugen Sie zunächst die zurückgegebene poll_url. Wenn Sie einen festen Task-Status-Endpunkt benötigen, verwenden Sie /v1/tasks/{id}; behalten Sie /v1/music/generations/{id} für musik-spezifische Kompatibilitätspfade.

​
3D-Generierung

EndpointMethodBeschreibung
/v1/3d/generationsPOST3D-Modell-Generierungsaufgabe erstellen
/v1/3d/generations/{id}GET3D-spezifischer Statuspfad
Für neue Clients bevorzugen Sie zunächst die zurückgegebene poll_url. Wenn Sie einen festen Task-Status-Endpunkt benötigen, verwenden Sie /v1/tasks/{id}; behalten Sie /v1/3d/generations/{id} für 3D-spezifische Kompatibilitätspfade.

​
Modelle

EndpointMethodBeschreibung
/v1/modelsGETAlle verfügbaren Modelle auflisten
/v1/models/{model}GETInformationen zu einem bestimmten Modell abrufen

​
Gemini (v1beta)

Native Unterstützung des Google Gemini API-Formats:
EndpointMethodBeschreibung
/v1beta/models/{model}:generateContentPOSTInhalte generieren (Gemini-Format)
/v1beta/models/{model}:streamGenerateContentPOSTInhalte streamen/generieren (Gemini-Format)
Gemini-Endpunkte unterstützen die Authentifizierung über den Query-Parameter ?key= zusätzlich zum standardmäßigen Bearer-Token.

​
Antwortformat

Alle Antworten folgen einem konsistenten Format:

​
Erfolgsantwort

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

​
Routing-Transparenz

Alle Antworten enthalten ein _routing-Feld mit Kanalinformationen: 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
FeldBeschreibung
channel.idVerwendete Channel-Kennung
channel.providerUpstream-Anbieter (openai, anthropic, etc.)
channel.channelTypePLATFORM (LemonData) oder PRIVATE (BYOK)
cachedOb die Antwort aus dem Cache geliefert wurde
retryCountAnzahl der Wiederholungsversuche (falls zutreffend)

​
Fehlerantwort

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

​
Rate Limits

Standardwerte:
RolleAnfragen/min
Benutzer60
Partner300
VIP1.000
Kontaktieren Sie den Support für benutzerdefinierte Rate Limits. Exakte Werte können je nach Kontokonfiguration variieren.
Wenn Rate Limits überschritten werden, gibt die API einen Statuscode 429 zurück mit einem Retry-After-Header, der angibt, wie lange gewartet werden soll.

​
OpenAPI Specification

OpenAPI-Spezifikation

Laden Sie die vollständige OpenAPI 3.0-Spezifikation herunter