Daten je Person, getrennt und löschbar.
Mit external_identifier ordnest du Verlauf, Erinnerungen und Dateien einer Person in deiner Anwendung zu. Löschst du sie, bekommst du einen Beleg, der auch danach noch abrufbar ist.
So entsteht ein Endnutzer.
Die Kennung vergibst du selbst. Sie ist eine stabile Zeichenfolge bis 255 Zeichen und bleibt in deinem Team. Der erste Aufruf mit einer unbekannten Kennung legt den Endnutzer an, mit POST /v1/end-users geht das auch vorab.
curl https://api.flowmodels.one/v1/chat/completions \
-H "Authorization: Bearer $FLOWMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-fable-5-1",
"external_identifier": "customer-42",
"messages": [{ "role": "user", "content": "Wie war noch mal mein Tarif?" }]
}'
curl https://api.flowmodels.one/v1/end-users \
-H "Authorization: Bearer $FLOWMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_identifier": "customer-42",
"metadata": { "plan": "pro" }
}'
Was die Kennung ändert.
external_identifier
- Der Verlauf liegt bei FlowModels, du schickst nur die neuen Nachrichten und die
conversationaus der letzten Antwort. - Passende Erinnerungen und Dateiabschnitte derselben Person kommen in den Kontext.
- Lange Verläufe werden zusammengefasst. Auch diese Modellaufrufe gehören zum bezahlten Verbrauch.
Ohne Kennung
- Der Verlauf gehört dir, du schickst ihn bei jedem Aufruf mit.
- FlowModels fasst nichts von selbst zusammen.
- Es wird keine Erinnerung gesucht und keine gespeichert.
Was je Person gespeichert wird.
| Daten | Grenzen | Zugriff |
|---|---|---|
| Metadaten | Höchstens 50 Einträge, Werte bis 1.000 Zeichen | PATCH /v1/end-users/{uuid} |
| Erinnerungen | Text bis 10.000 Zeichen je Erinnerung, automatische Erkennung abschaltbar | POST, GET, PATCH, DELETE /v1/memories |
| Dateien | 32 MB je Datei, 100 Dateien je Endnutzer, 5 GB je Team | POST, GET, DELETE /v1/end_users/{uuid}/files |
Dateien werden als Text ausgewertet. Erlaubt sind pdf, docx, doc, rtf, xlsx, pptx, txt, md und csv.
Automatische Erinnerungen sind bei neuen Endnutzern eingeschaltet. Mit memory_extraction_enabled: false schaltest du sie je Person ab.
curl https://api.flowmodels.one/v1/memories \
-H "Authorization: Bearer $FLOWMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_identifier": "customer-42",
"text": "Bevorzugt Antworten auf Deutsch."
}'
Löschen mit Beleg.
DELETE /v1/end-users/{uuid} entfernt die Arbeitsdaten dieser Person: Verlauf, Erinnerungen, Dateien und Protokolle. Private Dateien werden im Hintergrund gelöscht, der Beleg zeigt dir, wann das fertig ist. Abrechnungs- und Verbrauchszeilen bleiben erhalten.
Der Beleg enthält nur Zählungen, keinen Inhalt. Er bleibt auch nach dem Löschen unter der Kennung abrufbar, denn genau dann brauchst du ihn.
DELETE https://api.flowmodels.one/v1/end-users/018f1234-5678-7abc-9def-0123456789ab
Authorization: Bearer $FLOWMODELS_API_KEY
GET https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/erasures
Authorization: Bearer $FLOWMODELS_API_KEY
| Bereich | Vorher | Nachher |
|---|---|---|
memories |
12 | 0 |
end_user_files |
3 | 0 |
conversations |
7 | 0 |
messages |
86 | 0 |
stored_objects |
3 | 0 |
objects_remaining 0
FlowModels hat kein Budget je Endnutzer. Wie du den Verbrauch je Person trotzdem im Blick behältst, steht bei den Budgets.