FlowModels

API-Schlüssel per Schnittstelle anlegen, erneuern und löschen

Veröffentlicht am 11. November 2026

Wenn du für jeden Kunden, jede Umgebung oder jedes Deployment einen eigenen Schlüssel brauchst, musst du das nicht von Hand machen. Mit einem Schlüssel der Berechtigung Schlüssel verwalten kann dein Programm Schlüssel von FlowModels selbst anlegen, auflisten, erneuern und sperren. Hier steht, wie das geht und wo die Grenzen liegen.

Der Verwaltungsschlüssel

Lege zuerst im Dashboard unter API-Schlüssel einen Schlüssel mit der Berechtigung Schlüssel verwalten an, siehe API-Schlüssel anlegen: Berechtigung, Limit und Gültigkeit. Dieser Schlüssel kann selbst keine Modelle aufrufen. Er darf aber Schlüssel verwalten und Guthaben, Schlüsselstatus und Verbrauch abfragen.

Die Seite API-Schlüssel mit Schlüsseln für „KI nutzen“ und „Schlüssel verwalten“

Ein Schlüssel mit KI nutzen wird auf den Verwaltungsendpunkten mit 403 insufficient_key_scope abgelehnt.

Die Endpunkte

Die Schlüsselverwaltung liegt nicht auf api.flowmodels.one, sondern weiterhin auf creativeskyline.de. Alle Pfade beginnen mit https://creativeskyline.de/api/user/api-keys:

Aufgabe Aufruf
Schlüssel auflisten GET /api/user/api-keys
Schlüssel anlegen POST /api/user/api-keys
Schlüssel erneuern PUT /api/user/api-keys/{uuid}/regenerate
Schlüssel sperren DELETE /api/user/api-keys/{uuid}

Du verwaltest damit nur Schlüssel von FlowModels, die zu deinem Konto und deinem Team gehören. Die Liste enthält nur aktive Schlüssel und nie den Schlüsselwert selbst, sondern Name, uuid, kind, Anlagedatum, letzte Nutzung und Ablaufdatum.

Einen Schlüssel für Modellaufrufe anlegen

Wichtig ist das Feld kind. Lässt du es weg, entsteht wieder ein Verwaltungsschlüssel. Für Modellaufrufe setzt du ausdrücklich "kind": "inference":

curl -X POST https://creativeskyline.de/api/user/api-keys \
  -H "Authorization: Bearer at_dein_verwaltungsschluessel" \
  -H "Content-Type: application/json" \
  -d '{"name": "Kundenportal Staging", "kind": "inference", "expires_at": "2027-06-30"}'
  • name ist Pflicht, höchstens 255 Zeichen.
  • expires_at ist optional und muss in der Zukunft liegen.
  • kind kennt inference (entspricht KI nutzen) und management (entspricht Schlüssel verwalten).

Die Antwort enthält im Feld data.token den vollständigen Schlüssel, dazu uuid, name, kind und expires_at. Speichere den Wert sofort in deiner Geheimnisverwaltung. In der Oberfläche von FlowModels lässt er sich nicht noch einmal anzeigen. Der neue Schlüssel gehört automatisch zur FlowModels und rechnet über das Guthaben deines Teams ab.

Erneuern und sperren

PUT …/{uuid}/regenerate erzeugt einen neuen Wert und gibt ihn in data.token zurück. Der bisherige Wert funktioniert danach noch eine Übergangszeit lang, damit du ihn ohne Ausfall austauschen kannst. Plane den Austausch trotzdem zügig ein.

DELETE …/{uuid} sperrt den Schlüssel sofort. Jeder weitere Aufruf damit wird abgelehnt, und in der Liste dieses Endpunkts taucht er nicht mehr auf.

Was nur in der Oberfläche geht

Ein Monatliches Limit oder ein eigenes Anfragelimit für einen Schlüssel kannst du über diese Endpunkte nicht setzen. Öffne dafür den Schlüssel unter API-Schlüssel und bearbeite ihn, siehe API-Schlüssel bearbeiten, erneuern oder sperren. Auch Guthaben laden geht nur in der Oberfläche.

Grenzen eines Schlüssels abfragen

Mit GET https://api.flowmodels.one/v1/key fragt ein Programm ab, was für den gerade verwendeten Schlüssel gilt. Die Antwort nennt unter anderem status, kind, expires_at, last_used_at und unter limits:

  • spending.monthly_limit_micro_eur: das monatliche Limit in Micro-Euro, null ohne eigenes Limit
  • requests.tier und requests.per_minute: die Stufe und die Anfragen je Minute für diesen Schlüssel
  • concurrency.max_concurrent_requests: wie viele Anfragen gleichzeitig laufen dürfen
  • payload: die Größengrenzen einer einzelnen Anfrage

Eine Million Micro-Euro entsprechen einem Euro. Den Schlüsselwert und andere Schlüssel zeigt dieser Aufruf nie. Mehr dazu in Guthaben und Schlüsselgrenzen per API abfragen: GET /credits und GET /key.

Wenn etwas nicht klappt

  • Neuer Schlüssel bekommt 403 insufficient_key_scope bei Modellaufrufen: Er wurde ohne "kind": "inference" angelegt und ist ein Verwaltungsschlüssel. Lege einen neuen mit inference an und sperre den falschen.
  • 404 beim Erneuern oder Sperren: Die uuid gehört nicht zu deinem Konto oder der Schlüssel ist schon gesperrt.
  • Fehlermeldung beim Anlegen: Prüfe, ob name gesetzt ist, expires_at in der Zukunft liegt und kind genau inference oder management lautet.

War dieser Artikel hilfreich?

Zurück zu Erste Schritte & API-Schlüssel