Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Dateieingaben

Erfahre, wie du Dateien als Eingaben an die OpenAI API übergibst.

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-4o und 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, .txt und 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_file zu ü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.

Eine externe Datei-URL verwenden
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"
                    }
                ]
            }
        ]
    }'

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.

Eine Datei hochladen
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?"
                    }
                ]
            }
        ]
    }'

Base64-kodierte Dateien

Du kannst Dateieingaben auch als Base64-kodierte Dateidaten senden.

Eine Base64-kodierte Datei 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?"
                    }
                ]
            }
        ]
    }'

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 detail in der Responses API auf auto (Standard), low oder high, 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-4o oder ein neueres Modell.
  • Verwendungszweck beim Hochladen: Du kannst Dateien mit jedem unterstützten Verwendungszweck hochladen. Verwende user_data fü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: