Mit Code Interpreter können Modelle Python-Code in einer Sandbox schreiben und ausführen, um komplexe Aufgaben in der Datenanalyse, Programmierung und Mathematik zu lösen. Du kannst das Tool für folgende Aufgaben einsetzen:
- Dateien mit unterschiedlichen Daten und Formatierungen verarbeiten
- Dateien mit Daten und Diagramme als Bilddateien erstellen
- Code schrittweise entwickeln und ausführen, um Probleme zu lösen. Lässt sich der geschriebene Code beispielsweise nicht ausführen, kann das Modell ihn so lange überarbeiten und erneut ausführen, bis er läuft.
- Bilder mit
gpt-6-astrauntersuchen. Mit Python kann Code Interpreter Bilder zuschneiden, Bildausschnitte vergrößern, Bilder drehen oder die Werte einzelner Pixel auslesen.
Das folgende Beispiel zeigt, wie du die Responses API mit einem Tool-Aufruf für Code Interpreter verwendest:
curl https://api.openai.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"tools": [{
"type": "code_interpreter",
"container": { "type": "auto", "memory_limit": "4g" }
}],
"instructions": "You are a personal math tutor. When asked a math question, write and run code using the python tool to answer the question.",
"input": "I need to solve the equation 3x + 11 = 14. Can you help me?"
}'Wir nennen das Tool Code Interpreter. Das Modell kennt es als „python tool“. Modelle verstehen in der Regel auch Prompts, die Code Interpreter nennen. Am eindeutigsten ist es, wenn du in deinem Prompt ausdrücklich um die Verwendung von „the python tool“ bittest.
Container
Code Interpreter benötigt ein Containerobjekt. Ein Container ist eine vollständig isolierte virtuelle Maschine, in der das Modell Python-Code ausführen kann. Der Container kann sowohl Dateien enthalten, die du hochlädst, als auch Dateien, die das Modell erstellt.
Du kannst Container automatisch oder explizit erstellen.
- Automatischer Modus: Wenn du ein neues Response-Objekt erstellst, übergib wie im Beispiel oben die Eigenschaft
"container": { "type": "auto", "memory_limit": "4g", "file_ids": ["file-1", "file-2"] }in der Tool-Konfiguration. Die API erstellt dann automatisch einen neuen Container oder verwendet einen aktiven Container erneut, den ein früherescode_interpreter_call-Element im Modellkontext verwendet hat. Wenn dumemory_limitweglässt, erhält der Container standardmäßig 1 GB Arbeitsspeicher. Suche in der Ausgabe dieser API-Anfrage nach dem Elementcode_interpreter_call. Dort findest du diecontainer_iddes neu erstellten oder wiederverwendeten Containers. - Expliziter Modus: Hier erstellst du selbst einen Container über den Endpunkt
v1/containersund gibst mitmemory_limitden benötigten Arbeitsspeicher an (zum Beispiel"memory_limit": "4g"). Trage anschließend seineidals Wert fürcontainerin die Tool-Konfiguration des Response-Objekts ein. Ein Beispiel:
curl https://api.openai.com/v1/containers \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Container",
"memory_limit": "4g"
}'
# Use the returned container id in the next call:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-astra",
"tools": [{
"type": "code_interpreter",
"container": "cntr_abc123"
}],
"tool_choice": "required",
"input": "use the python tool to calculate what is 4 * 3.82. and then find its square root and then find the square root of that result"
}'Du kannst zwischen 1g (Standard), 4g, 16g und 64g wählen. Höhere Speicherstufen bieten mehr Arbeitsspeicher für die Sitzung. Für die Abrechnung gelten die Preise für integrierte Tools für Code Interpreter. Der für memory_limit gewählte Wert gilt für die gesamte Lebensdauer des Containers, unabhängig davon, ob er automatisch oder über die Containers API erstellt wurde.
Auch auf automatisch erstellte Container kannst du über den Endpunkt /v1/containers zugreifen.
Ablauf von Containern
Wir empfehlen dir dringend, Container als temporär zu behandeln und alle Daten, die bei der Nutzung des Tools anfallen, auf deinen eigenen Systemen zu speichern. Für den Ablauf gilt:
- Bleibt ein Container 20 Minuten lang ungenutzt, läuft er ab. Danach schlagen Anfragen an
v1/responsesfehl, die diesen Container verwenden. Du kannst weiterhin den Stand der Containermetadaten zum Zeitpunkt des Ablaufs einsehen. Alle zugehörigen Daten werden jedoch von unseren Systemen gelöscht und lassen sich nicht wiederherstellen. Lade alle Dateien, die du später brauchen könntest, herunter, solange der Container aktiv ist. - Einen abgelaufenen Container kannst du nicht wieder aktivieren. Erstelle einen neuen Container und lade die Dateien erneut hoch. Alles, was im Arbeitsspeicher des alten Containers lag, etwa Python-Objekte, geht verloren.
- Jeder Zugriff auf den Container aktualisiert automatisch den Zeitstempel
last_active_at. Das gilt beispielsweise, wenn du den Container abrufst oder Dateien hinzufügst oder löschst.
Mit Dateien arbeiten
Mit Code Interpreter kann das Modell eigene Dateien erstellen. Wenn du es beispielsweise bittest, ein Diagramm zu zeichnen oder eine CSV-Datei zu erstellen, speichert es das Ergebnis direkt in deinem Container. In seiner nächsten Nachricht verweist das Modell im Feld annotations auf diese Dateien. Ein Beispiel:
{
"id": "msg_682d514e268c8191a89c38ea318446200f2610a7ec781a4f",
"content": [
{
"annotations": [
{
"file_id": "cfile_682d514b2e00819184b9b07e13557f82",
"index": null,
"type": "container_file_citation",
"container_id": "cntr_682d513bb0c48191b10bd4f8b0b3312200e64562acc2e0af",
"end_index": 0,
"filename": "cfile_682d514b2e00819184b9b07e13557f82.png",
"start_index": 0
}
],
"text": "Here is the histogram of the RGB channels for the uploaded image. Each curve represents the distribution of pixel intensities for the red, green, and blue channels. Peaks toward the high end of the intensity scale (right-hand side) suggest a lot of brightness and strong warm tones, matching the orange and light background in the image. If you want a different style of histogram (e.g., overall intensity, or quantized color groups), let me know!",
"type": "output_text",
"logprobs": []
}
],
"role": "assistant",
"status": "completed",
"type": "message"
}
Mit der Methode zum Abrufen des Inhalts einer Containerdatei kannst du die erstellten Dateien herunterladen.
Alle Dateien in der Modelleingabe werden automatisch in den Container hochgeladen. Du musst sie nicht separat hochladen.
Dateien hochladen und herunterladen
Mit Containerdatei erstellen fügst du deinem Container neue Dateien hinzu. Dieser Endpunkt akzeptiert entweder einen Multipart-Upload oder einen JSON-Body mit einer file_id.
Mit Containerdateien auflisten rufst du eine Liste der vorhandenen Dateien ab. Über Inhalt einer Containerdatei abrufen kannst du die Dateidaten als Bytes herunterladen.
Dateiverweise auswerten
Die Nachricht des Assistenten enthält Anmerkungen, die auf die vom Modell erstellten Dateien und Bilder verweisen. Anmerkungen vom Typ container_file_citation verweisen auf Dateien, die im Container erstellt wurden. Sie enthalten die Felder container_id, file_id und filename. Du kannst diese Anmerkungen auswerten, um Downloadlinks anzuzeigen oder die Dateien anderweitig zu verarbeiten.
Unterstützte Dateiformate
| Dateiformat | MIME-Typ |
|---|---|
.c |
text/x-c |
.cs |
text/x-csharp |
.cpp |
text/x-c++ |
.csv |
text/csv |
.doc |
application/msword |
.docx |
application/vnd.openxmlformats-officedocument.wordprocessingml.document |
.html |
text/html |
.java |
text/x-java |
.json |
application/json |
.md |
text/markdown |
.pdf |
application/pdf |
.php |
text/x-php |
.pptx |
application/vnd.openxmlformats-officedocument.presentationml.presentation |
.py |
text/x-python |
.py |
text/x-script.python |
.rb |
text/x-ruby |
.tex |
text/x-tex |
.txt |
text/plain |
.css |
text/css |
.js |
text/javascript |
.sh |
application/x-sh |
.ts |
application/typescript |
.csv |
application/csv |
.jpeg |
image/jpeg |
.jpg |
image/jpeg |
.gif |
image/gif |
.pkl |
application/octet-stream |
.png |
image/png |
.tar |
application/x-tar |
.xlsx |
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
.xml |
application/xml or "text/xml" |
.zip |
application/zip |
Hinweise zur Nutzung
| API-Verfügbarkeit | Ratenlimits | Hinweise |
|---|---|---|
| 100 Anfragen pro Minute und Organisation |