Welche Dateieingaben du verwenden kannst, hängt vom API-Endpunkt ab. Die Responses API akzeptiert die unten aufgeführten Dateitypen als input_file-Elemente. Chat Completions akzeptiert nur PDF-Dateien als Inhaltselemente vom Typ file.
| Eingabemethode | Responses API | Chat Completions |
|---|---|---|
Base64-kodierte Dateidaten (file_data) |
Unten aufgeführte Dateitypen | Nur PDF |
ID einer hochgeladenen Datei (file_id) |
Unten aufgeführte Dateitypen | Nur PDF |
Externe Datei-URL (file_url) |
Unten aufgeführte Dateitypen | Nicht unterstützt |
Verwende die Responses API für Dateieingaben in anderen Formaten als PDF. Wenn du Text aus einer Datei in Chat Completions verwenden möchtest, lies die Datei in deiner Anwendung ein und sende ihren Inhalt als Inhaltselement vom Typ text.
Funktionsweise
Wie die Responses API ein input_file-Element verarbeitet, hängt vom Dateityp ab:
- PDF-Dateien: Bei Modellen, die Bilder verarbeiten können, etwa
gpt-4ound neueren Modellen, extrahiert die API sowohl den Text als auch Bilder der einzelnen Seiten und sendet beides an das Modell. - Dokumente und Textdateien in anderen Formaten als PDF (z. B.
.docx,.pptx,.txtund Quellcodedateien): Die API extrahiert nur den Text. - Tabellendateien (z. B.
.xlsx,.csv,.tsv): Die API bereitet die Tabellendaten wie unten beschrieben für das Modell auf.
Je nach Aufgabe können diese Werkzeuge besser geeignet sein:
- Verwende File Search, um relevante Inhalte in großen Dateien zu finden, statt die Dateien direkt als
input_filezu übergeben. - Verwende Hosted Shell, wenn du Tabellendaten im Detail analysieren möchtest, etwa um Daten zu aggregieren, Tabellen per Join zu verknüpfen, Diagramme zu erstellen oder eigene Berechnungen durchzuführen.
Einschränkungen bei Bildern und Diagrammen außerhalb von PDFs
Bei Dateien in anderen Formaten als PDF übernimmt die Responses API eingebettete Bilder und Diagramme nicht in den Modellkontext.
Damit Schaubilder und Diagramme originalgetreu erhalten bleiben, konvertiere die Datei zuerst in eine PDF-Datei und sende diese dann als input_file.
So bereitet die API Tabellendaten auf
Für Dateien mit tabellarischen Daten (etwa .xlsx, .xls, .csv, .tsv und .iif) verwendet die Responses API ein speziell auf Tabellen zugeschnittenes Verfahren.
Statt ganze Tabellenblätter an das Modell zu übergeben, liest die API pro Blatt höchstens die ersten 1.000 Zeilen ein. Sie ergänzt eine vom Modell erstellte Zusammenfassung sowie vom Modell erzeugte Metadaten zu den Spaltenüberschriften. So kann das Modell mit einer kompakten, strukturierten Ansicht der Daten arbeiten.
Detailstufen für PDFs
Bei PDF-Eingaben in der Responses API kannst du im optionalen Feld detail eines input_file-Elements den Wert auto, low oder high angeben. Damit steuerst du, wie die API die Seitenbilder verarbeitet. Wenn du das Feld weglässt, gilt für detail der Standardwert auto. Bei GPT-5.6 und neueren Modellen entspricht auto der Einstellung high, bei früheren Modellen der Einstellung low. Wähle low, um weniger Eingabetoken zu verbrauchen, oder high, wenn feine Details wichtig sind, etwa bei Diagrammen mit vielen Datenpunkten, Kleingedrucktem oder Schaubildern.
Die Einstellung detail betrifft nur die Verarbeitung der PDF-Seitenbilder. Der aus der PDF-Datei extrahierte Text bleibt im Modellkontext enthalten. Dateieingaben in Chat Completions unterstützen detail nicht.
So sieht der Inhalt einer minimalen Anfrage an die Responses API mit explizit festgelegter hoher Detailstufe aus:
{
"model": "gpt-4.1",
"input": [
{
"role": "user",
"content": [
{
"type": "input_file",
"filename": "document.pdf",
"file_data": "data:application/pdf;base64,...",
"detail": "high"
},
{
"type": "input_text",
"text": "Summarize this document."
}
]
}
]
}
Unterstützte Dateitypen
Die folgende Tabelle zeigt gängige Dateitypen, die die Responses API als input_file-Elemente akzeptiert. Die vollständige Liste der Dateiendungen und MIME-Typen findest du weiter unten auf dieser Seite. Chat Completions unterstützt ausschließlich .pdf (application/pdf), sowohl für file_data als auch für file_id.
| Kategorie | Gängige Dateiendungen |
|---|---|
| PDF-Dateien | .pdf |
| Text und Code | .txt, .md, .json, .html, .xml, Quellcodedateien |
| Formatierte Dokumente | .doc, .docx, .rtf, .odt |
| Präsentationen | .ppt, .pptx |
| Tabellendateien | .csv, .xls, .xlsx |
Datei-URLs
Du kannst Dateien als Eingaben übergeben, indem du ihre externen URLs angibst.
curl "https://api.openai.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"input": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "Analyze the letter and provide a summary of the key points."
},
{
"type": "input_file",
"file_url": "https://www.berkshirehathaway.com/letters/2024ltr.pdf"
}
]
}
]
}'Chat Completions unterstützt keine Datei-URLs. Verwende dafür die Responses API.
Dateien hochladen
Das folgende Beispiel lädt eine Datei über die Files API hoch und verwendet anschließend die Datei-ID in einer Anfrage an das Modell.
curl https://api.openai.com/v1/files \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-F purpose="user_data" \
-F file="@draconomicon.pdf"
curl "https://api.openai.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"input": [
{
"role": "user",
"content": [
{
"type": "input_file",
"file_id": "file-6F2ksmvXxt4VdoqmHRw6kL"
},
{
"type": "input_text",
"text": "What is the first dragon in the book?"
}
]
}
]
}'curl https://api.openai.com/v1/files \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-F purpose="user_data" \
-F file="@draconomicon.pdf"
curl "https://api.openai.com/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"messages": [
{
"role": "user",
"content": [
{
"type": "file",
"file": {
"file_id": "file-6F2ksmvXxt4VdoqmHRw6kL"
}
},
{
"type": "text",
"text": "What is the first dragon in the book?"
}
]
}
]
}'Base64-kodierte Dateien
Du kannst Dateieingaben auch als Base64-kodierte Dateidaten senden.
curl "https://api.openai.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"input": [
{
"role": "user",
"content": [
{
"type": "input_file",
"filename": "draconomicon.pdf",
"file_data": "...base64 encoded PDF bytes here..."
},
{
"type": "input_text",
"text": "What is the first dragon in the book?"
}
]
}
]
}'curl "https://api.openai.com/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"messages": [
{
"role": "user",
"content": [
{
"type": "file",
"file": {
"filename": "draconomicon.pdf",
"file_data": "...base64 encoded bytes here..."
}
},
{
"type": "text",
"text": "What is the first dragon in the book?"
}
]
}
]
}'Hinweise zur Verwendung
Beachte bei Dateieingaben die folgenden Bedingungen:
- Tokenverbrauch: Bei der PDF-Verarbeitung gelangen sowohl der extrahierte Text als auch die Seitenbilder in den Modellkontext. Dadurch kann der Tokenverbrauch steigen. Setze
detailin der Responses API aufauto(Standard),lowoderhigh, um die Detailstufe für PDF-Seitenbilder zu steuern. Prüfe vor dem Einsatz in größerem Umfang die Preise und den zu erwartenden Tokenverbrauch. Mehr zu den Preisen. - Dateigröße: Du kannst mehrere Dateien in einer Anfrage übergeben. Jede einzelne Datei muss kleiner als 50 MB sein. Zusammen dürfen die Dateien in einer Anfrage höchstens 50 MB groß sein.
- Unterstützte Modelle: Um sowohl den Text als auch die Seitenbilder einer PDF-Datei zu verarbeiten, brauchst du ein Modell, das Bilder verarbeiten kann, etwa
gpt-4ooder ein neueres Modell. - Verwendungszweck beim Hochladen: Du kannst Dateien mit jedem unterstützten Verwendungszweck hochladen. Verwende
user_datafür Dateien, die du als Eingaben an ein Modell übergeben möchtest.
Vollständige Liste der unterstützten Dateitypen
Diese Liste gilt für die Responses API. Chat Completions unterstützt ausschließlich .pdf (application/pdf), sowohl für file_data als auch für file_id.
| Kategorie | Dateiendungen | MIME-Typen |
|---|---|---|
| PDF-Dateien | PDF-Dateien (.pdf) |
application/pdf |
| Tabellendateien | Excel-Tabellen (.xla, .xlb, .xlc, .xlm, .xls, .xlsx, .xlt, .xlw) |
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel |
| Tabellendateien | CSV / TSV / IIF (.csv, .tsv, .iif), Google Tabellen |
text/csv, application/csv, text/tsv, text/x-iif, application/x-iif, application/vnd.google-apps.spreadsheet |
| Formatierte Dokumente | Word-, ODT- und RTF-Dokumente (.doc, .docx, .dot, .odt, .rtf), Pages, Google Docs |
application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/msword, application/rtf, text/rtf, application/vnd.oasis.opendocument.text, application/vnd.apple.pages, application/vnd.google-apps.document, application/vnd.apple.iwork |
| Präsentationen | PowerPoint-Folien (.pot, .ppa, .pps, .ppt, .pptx, .pwz, .wiz), Keynote, Google Präsentationen |
application/vnd.openxmlformats-officedocument.presentationml.presentation, application/vnd.ms-powerpoint, application/vnd.apple.keynote, application/vnd.google-apps.presentation, application/vnd.apple.iwork |
| Text und Code | Text- und Codeformate (.asm, .bat, .c, .cc, .conf, .cpp, .css, .cxx, .def, .dic, .eml, .h, .hh, .htm, .html, .ics, .ifb, .in, .js, .json, .ksh, .list, .log, .markdown, .md, .mht, .mhtml, .mime, .mjs, .nws, .pl, .py, .rst, .s, .sql, .srt, .text, .txt, .vcf, .vtt, .xml) |
application/javascript, application/typescript, text/xml, text/x-shellscript, text/x-rst, text/x-makefile, text/x-lisp, text/x-asm, text/vbscript, text/css, message/rfc822, application/x-sql, application/x-scala, application/x-rust, application/x-powershell, text/x-diff, text/x-patch, application/x-patch, text/plain, text/markdown, text/x-java, text/x-script.python, text/x-python, text/x-c, text/x-c++, text/x-golang, text/html, text/x-php, application/x-php, application/x-httpd-php, application/x-httpd-php-source, text/x-ruby, text/x-sh, text/x-bash, application/x-bash, text/x-zsh, text/x-tex, text/x-csharp, application/json, text/x-typescript, text/javascript, text/x-go, text/x-rust, text/x-scala, text/x-kotlin, text/x-swift, text/x-lua, text/x-r, text/x-R, text/x-julia, text/x-perl, text/x-objectivec, text/x-objectivec++, text/x-erlang, text/x-elixir, text/x-haskell, text/x-clojure, text/x-groovy, text/x-dart, text/x-awk, application/x-awk, text/jsx, text/tsx, text/x-handlebars, text/x-mustache, text/x-ejs, text/x-jinja2, text/x-liquid, text/x-erb, text/x-twig, text/x-pug, text/x-jade, text/x-tmpl, text/x-cmake, text/x-dockerfile, text/x-gradle, text/x-ini, text/x-properties, text/x-protobuf, application/x-protobuf, text/x-sql, text/x-sass, text/x-scss, text/x-less, text/x-hcl, text/x-terraform, application/x-terraform, text/x-toml, application/x-toml, application/graphql, application/x-graphql, text/x-graphql, application/x-ndjson, application/json5, application/x-json5, text/x-yaml, application/toml, application/x-yaml, application/yaml, text/x-astro, text/srt, application/x-subrip, text/x-subrip, text/vtt, text/x-vcard, text/calendar |
Nächste Schritte
Hier findest du Beispiele und weitere Informationen zur Arbeit mit Dateieingaben: