Du kannst einem Modell neben Text auch Bilder, PDFs, Office-Dokumente und Audio mitschicken, etwa um eine Rechnung auslesen oder ein Foto beschreiben zu lassen. Die Anhänge stehen dabei direkt in der Nachricht, im Format von OpenAI. Hier erfährst du, welche Wege es gibt, wie groß Anhänge sein dürfen und was passiert, wenn ein Modell einen Dateityp nicht selbst versteht.
Anhänge in einer Nachricht
Statt eines einfachen Textes schickst du in content eine Liste von Blöcken. Erlaubt sind diese Typen:
text: normaler Textimage_url: ein Bildfile: ein Dokument oder eine andere Dateiinput_audio: Audio im Formatwavodermp3
Anhänge sind nur in Nachrichten mit role: "user" erlaubt. In System-, Assistenten- oder Tool-Nachrichten lehnt die API sie mit 400 unsupported_field ab.
{
"model": "openai/gpt-5.6-luna",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Was ist auf dem Foto zu sehen?"},
{"type": "image_url", "image_url": {"url": "https://www.example.de/bilder/lager.jpg"}}
]
}]
}
Drei Wege, eine Datei zu übergeben
Ein file-Block enthält genau eine dieser Quellen:
file_url: eine öffentlich erreichbarehttps-Adresse. Wir laden die Datei selbst.file_data: die Datei als Base64, zusammen mitfilename. Direkt mitgeschickte Daten sind auf insgesamt 8 MiB je Anfrage begrenzt.file_id: eine Datei, die du vorher hochgeladen hast (siehe unten).
{"type": "file", "file": {"file_id": "file-018f1234-5678-7abc-9def-0123456789ab"}}
Bilder gehen über image_url als https-Adresse oder als data:-Adresse mit Base64. Schickst du in einem Block mehrere Quellen gleichzeitig, wird die Anfrage abgelehnt.
Dateien vorher hochladen
Für große Dateien oder wenn du dieselbe Datei mehrmals brauchst, lädst du sie einmal hoch:
curl -X POST https://api.flowmodels.one/v1/files \
-H "Authorization: Bearer at_dein_schluessel" \
-F "file=@rechnung-2026-117.pdf" \
-F "purpose=user_data"
purposeistuser_dataodervision.- Eine Datei darf höchstens 32 MiB groß sein. Größere Dateien lehnt die API mit
413 file_too_largeab. - Die Antwort enthält die
id, die du später alsfile_idverwendest. - Hochgeladene Dateien bleiben gespeichert, bis du sie löschst. Eine automatische Löschfrist gibt es nicht. Lösche nicht mehr benötigte Dateien mit
DELETE /v1/files/{id}.
GET /v1/files listet deine Dateien, GET /v1/files/{id} zeigt nur die Angaben zur Datei, und GET /v1/files/{id}/content lädt den Inhalt herunter.
Was das Modell mit dem Anhang macht
- Bilder und Videos sieht nur ein Modell, das diesen Typ unterstützt. Ob es Bilder versteht, steht in
GET /modelsuntercapabilities.vision. Sonst kommt400 unsupported_for_model. - Dokumente, die ein Modell nicht selbst lesen kann, wandeln wir vorher in Text um. Das Modell bekommt dann den extrahierten Text.
- Audio, das ein Modell nicht selbst hören kann, wird vorher transkribiert. Diese Transkription wird zusätzlich berechnet.
Abgrenzung zu den Endnutzerdateien
Anhänge an einer Nachricht gehen direkt an das Modell und nur für diese Anfrage. Willst du einem Endnutzer deiner Anwendung dauerhaft Dokumente zuordnen, die das Brain bei späteren Fragen heranzieht, nimm die Endnutzerdateien, siehe Dokumente für einen Endnutzer hochladen und als Kontext nutzen.
Wenn etwas nicht klappt
400 unsupported_for_modelbei einem Bild: Das Modell hat keine Bilderkennung. Wähle ein Modell mitvision: true.400 unsupported_field: Der Anhang steht nicht in einer Nutzernachricht, oder der Blocktyp ist unbekannt.- Datei-URL wird abgelehnt: Sie muss mit
https://beginnen und öffentlich erreichbar sein. Interne Adressen und Adressen mit Anmeldung funktionieren nicht. 413 file_too_large: Eine Datei ist größer als 32 MiB, oder die direkt mitgeschickten Daten überschreiten 8 MiB. Verkleinere die Datei, lade sie vorher hoch oder übergib eine URL.