Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
Überblick

Mit der Management API können Sie Organisationsguthaben abrufen, Organisations-API-Keys verwalten und Nutzung sowie Billing für einen bestimmten Key abrufen, ohne einen normalen Inference-API-Key zu verwenden. Verwenden Sie ein Management-Token von der Settings-Seite im Dashboard: 
Authorization: Bearer mt-your-management-token
Management-Tokens sind nicht dasselbe wie Inference-API-Keys. Verwenden Sie mt-... für /v1/management/* und sk-... für Modell-Inference-Endpunkte wie /v1/responses.

​
Verfügbare Endpunkte

EndpointMethodBeschreibung
/v1/management/balanceGETRuft aktuelle Guthabensummen der Organisation ab
/v1/management/api-keysGETListet benutzerverwaltete API-Keys in der aktuellen Organisation auf
/v1/management/api-keysPOSTErstellt einen neuen Benutzer-API-Key
/v1/management/api-keys/{keyId}PATCHAktualisiert Name, Nutzungslimit, erlaubte Modelle, Ablaufzeit oder Status
/v1/management/api-keys/{keyId}/usageGETRuft paginierte Nutzungsdetails für einen bestimmten Key ab
/v1/management/api-keys/{keyId}/billingGETRuft aggregierte Billing-Aufschlüsselungen für einen bestimmten Key ab

​
Vertragsdetails für Nutzungsfilter

GET /v1/management/api-keys/{keyId}/usage unterstützt die folgenden Query-Parameter:
ParameterTypStandard / GrenzenBeschreibung
pageintegerStandard 1, min. 1Seitennummer ab 1
limitintegerStandard 50, min. 1, max. 100Seitengröße
logicalModelstringmax. Länge 100Angeforderter logischer Modellname
modelVendorstringmax. Länge 100Öffentlicher Modellanbieter
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform oder byok
startDatestring-Inklusive Untergrenze; akzeptiert RFC3339 mit Zeitzone oder YYYY-MM-DD
endDatestring-Inklusive Obergrenze; akzeptiert RFC3339 mit Zeitzone oder YYYY-MM-DD
Wenn startDate und endDate zusammen angegeben werden, muss startDate kleiner oder gleich endDate sein.

​
API-Key-Body-Vertrag

​
POST /v1/management/api-keys

FeldTypStandard / GrenzenBeschreibung
namestringerforderlich, Standard Default Key, Länge 1-50Anzeigename; führende und nachgestellte Leerzeichen werden serverseitig entfernt
limitAmountnumber | nullmin. 0, Eingabe max. 1000000null oder weggelassen = unbegrenzt, 0 = Nullkontingent. Positive Werte werden auf ein gespeichertes Limit normalisiert, das 100000 USD Gegenwert nicht überschreiten kann.
limitCurrencyenumStandardwert USDNur USD. Das Senden von CNY gibt 400 currency_retired zurück.
modelsstring[]Standard []Optionale Allowlist für logische Modelle
expiresAtstring | nullRFC3339-Datetimenull bedeutet ohne Ablaufzeit

​
PATCH /v1/management/api-keys/

FeldTypStandard / GrenzenBeschreibung
statusenum-active, inactive, suspended, revoked
namestringLänge 1-50Aktualisierter Anzeigename
limitAmountnumber | nullmin. 0, Eingabe max. 1000000null = unbegrenzt, 0 = Nullkontingent. Positive Werte werden auf ein gespeichertes Limit normalisiert, das 100000 USD Gegenwert nicht überschreiten kann.
limitCurrencyenumStandardwert USDNur USD. Das Senden von CNY gibt 400 currency_retired zurück.
modelsstring[]-Aktualisierte Allowlist für logische Modelle
expiresAtstring | nullRFC3339-Datetimenull entfernt die Ablaufzeit
Mindestens ein PATCH-Feld muss angegeben werden.

​
Währungs-Vertrag

​
Reporting-Semantik

  • logicalModel bezeichnet das öffentliche logische Modell, das vom Aufrufer angefordert wurde.
  • modelVendor bezeichnet den öffentlichen Modellanbieter, nicht die verborgene physische Route.
  • scene ist die öffentliche Request-Szene, die aus Endpoint oder Task-Typ abgeleitet wird.
  • accessChannel=platform bedeutet, dass die Anfrage über LemonDatas Plattformkanal abgerechnet wurde.
  • accessChannel=byok bedeutet, dass die Anfrage Ihren eigenen Upstream-Provider-Key verwendet hat.
Die Antworten geben nur öffentliche Billing- und Reporting-Felder zurück. Interne Routing-Details und Metadaten physischer Provider bleiben verborgen.
  • Einzelne /usage-Zeilen können billing_transaction_id enthalten, sobald die zugrunde liegende Anfrage den abgerechneten Zustand erreicht hat. Verwenden Sie request_id + billing_transaction_id für den Abgleich auf Anfrageebene.

​
Hinweis zur Billing-Paginierung

/usage ist paginiert. /billing ist derzeit ein aggregierter Breakdown-Endpunkt und liefert keine page / limit-Paginierungsmetadaten. Wenn Sie Einzelzeilen benötigen, verwenden Sie /usage.

​
Schnellbeispiel

Prüfen Sie zunächst das Organisationsguthaben mit dem aktuellen Management-Token: 
curl -X GET "https://api.lemondata.cc/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"
Listen Sie danach die API-Keys auf, die demselben Management-Token zur Verfügung stehen: 
curl "https://api.lemondata.cc/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-abc123...",
      "status": "active",
      "limit_amount": 500.0,
      "used_amount": 148.25,
      "models": ["gpt-4o-mini", "claude-3-7-sonnet"],
      "expires_at": "2026-04-30T00:00:00.000Z",
      "last_used_at": "2026-03-27T08:12:45.000Z",
      "created_at": "2026-03-01T10:00:00.000Z"
    }
  ]
}

​
Nächste Schritte