Am 11. März 2025 haben wir die Bausteine unserer neuen Agents-Plattform veröffentlicht. Weitere Informationen findest du in unserer API-Dokumentation zur Responses API, zu Tools wie Web Search, File Search und Computer Use sowie zu unserem Agents SDK mit Tracing. Auf Grundlage deines Feedbacks zur Beta der Assistants API haben wir wichtige Verbesserungen in die Responses API integriert. Sobald vollständige Funktionsgleichheit erreicht ist, kündigen wir später in diesem Jahr einen Plan zur Einstellung der Assistants API an, mit dem Ziel, sie in der ersten Hälfte des Jahres 2026 abzuschalten.
Häufig gestellte Fragen
Was ist die Assistants API?
Mit der Assistants API können Entwicklungsteams ganz einfach leistungsfähige KI-Assistenten für ihre Apps entwickeln. Die API übernimmt die Verwaltung des Gesprächsverlaufs und bietet Zugriff auf von OpenAI gehostete Tools wie Code Interpreter und File Search. Die API unterstützt außerdem verbesserte Funktionsaufrufe für Tools von Drittanbietern.
Kann ich die Betaversion v1 der Assistants API weiterhin verwenden?
Nein. Seit dem 18. Dezember 2024 haben Nutzende keinen Zugriff mehr auf die v1 der Betaversion der Assistants API. Derzeit unterstützen wir nur v2. In diesem Migrationsleitfaden erfährst du, wie du deine API-Aufrufe von v1 auf v2 umstellst.
Wie greife ich darauf zu?
Die Assistants API ist für alle mit einem OpenAI-API-Konto verfügbar, ist jedoch veraltet und wird im August 2026 entfernt. Verwende für neue Projekte stattdessen die Responses API. Wenn du die Assistants API bereits verwendest, plane deine Migration zur Responses API. Du kannst weiterhin im Assistants Playground auf bestehende Assistants zugreifen, solange die API verfügbar bleibt.
Was ist ein Assistent?
Ein Assistent ist eine für einen bestimmten Zweck entwickelte KI, die Modelle von OpenAI nutzt. Er kann auf Dateien zugreifen, dauerhafte Threads verwalten und Tools aufrufen.
Was ist ein Thread?
Ein Thread ist eine Gesprächssitzung zwischen einem Assistenten und einer Person, die ihn nutzt. Threads vereinfachen die Anwendungsentwicklung: Sie speichern den Nachrichtenverlauf und kürzen ihn, wenn das Gespräch die Kontextlänge des Modells überschreitet.
Was ist das Tool File Search?
Das Tool file_search nutzt standardmäßig mehrere bewährte Retrieval-Verfahren. Damit kannst du die passenden Daten aus deinen Dateien extrahieren, um die Antworten des Modells zu ergänzen.
Das Tool file_search verwendet standardmäßig folgende Einstellungen:
Chunk-Größe: 800 Tokens
Chunk-Überlappung: 400 Tokens
Embedding-Modell: text-embedding-3-large mit 256 Dimensionen
Maximale Anzahl der zum Kontext hinzugefügten Chunks: 20
Welche Beschränkungen gelten für das Hochladen von Dateien?
Für das Hochladen einer Datei gelten folgende Beschränkungen:
512 MB pro Datei
5 Mio. Tokens pro Datei
10.000 Dateien pro Vektorspeicher
1 Vektorspeicher pro Assistent
1 Vektorspeicher pro Thread
Das gesamte Speicherlimit pro Projekt innerhalb einer Organisation beträgt 100 GB.
Welche Einschränkungen hat das Tool File Search?
Es gibt einige bekannte Einschränkungen, an deren Behebung wir in den kommenden Monaten arbeiten:
Derzeit lassen sich die Einstellungen für Chunking, Embeddings und Retrieval nicht ändern.
Die Verarbeitung von Bildern innerhalb von Dokumenten wird nicht unterstützt.
Die Suche in strukturierten Dateiformaten (wie .csv- oder .jsonl-Dateien) wird nicht unterstützt. Sieh dir die unterstützten Dateitypen an.
Welche Ratenlimits gelten für die Assistants API?
Die Ratenlimits der Assistants API hängen nicht von Nutzungsstufe und Modell ab. Stattdessen gelten mit einigen Ausnahmen Standardlimits je nach Anfragetyp:
GET: 1.000 RPM
POST: 300 RPM
DELETE: 300 Anfragen pro Minute
Was kostet Code Interpreter in der API?
Code Interpreter kostet 0,03 USD pro Sitzung. Wenn dein Assistent Code Interpreter gleichzeitig in zwei verschiedenen Threads aufruft, entstehen zwei Code Interpreter-Sitzungen (2 × 0,03 USD). Jede Sitzung ist standardmäßig eine Stunde lang aktiv. Du zahlst diese Gebühr also nur einmal, wenn eine Person Code Interpreter bis zu einer Stunde lang im selben Thread weitere Anweisungen gibt.
Was kostet File Search in der API?
File Search kostet 0,10 USD pro GB Vektorspeicher und Tag (das erste GB Speicher ist kostenlos). Die Größe des Vektorspeichers ergibt sich aus dem Speicherbedarf, nachdem deine Datei verarbeitet, in Chunks aufgeteilt und in Embeddings umgewandelt wurde.
Alle vor dem 17. April 2024 erstellten Vektorspeicher bleiben bis Ende 2024 kostenlos. Danach werden sie entweder:
Zu den aktuellen Preisen (derzeit 0,10 USD pro GB und Tag) abgerechnet, wenn sie mindestens einmal in einem nach dem 17. April 2024 erstellten Run verwendet wurden.
Gelöscht, wenn sie zwischen dem 17. April 2024 und dem 31. Dezember 2024 in keinem einzigen Run verwendet wurden. So entstehen dir keine Kosten für Vektorspeicher, die du möglicherweise vor der Ankündigung dieser Preisänderung erstellt, aber nie genutzt hast.
Gibt es eine Begrenzung dafür, wie viele Assistants ich erstellen kann?
Es gibt keine Begrenzung dafür, wie viele Assistants eine Organisation erstellen kann.
Ist Streaming über die API verfügbar?
Ja, Streaming ist über die Assistants API verfügbar.
Ist der JSON-Modus in der Assistants API verfügbar?
Ja, der JSON-Modus ist in der Assistants API über den Parameter response_format der Assistants- oder Run-Objekte verfügbar.
Verwaltet die Assistants API auch Anfragen für Funktionsaufrufe bei Drittanbietern?
Nein. Über Funktionsaufrufe kann das Modell zwar Tools auswählen und Anfragen dafür formatieren, die Ausführung von Aufrufen an Tools von Drittanbietern wird jedoch nicht von OpenAI verwaltet.
Wie werden die Daten behandelt, die ich an OpenAI sende?
Wie auf unserer gesamten Plattform werden Daten und Dateien, die an die OpenAI API übermittelt werden, niemals zum Trainieren unserer Modelle verwendet. Du kannst deine Daten jederzeit löschen. Die in die Assistants API hochgeladenen Daten werden unbefristet gespeichert, bis eine Person, die die API nutzt, sie manuell löscht.
Ist DALL-E über die Assistants API verfügbar?
DALL-E ist derzeit nicht verfügbar.
Gibt es eine Benutzeroberfläche für die Assistants API?
Du kannst dir den Playground für die Assistants API ansehen. Achte darauf, dass du in der linken Seitenleiste die Ansicht Assistants geöffnet hast und ein Modell verwendest, das mit den Tools kompatibel ist, die du aktivieren möchtest.
Welches Zeichenlimit gilt für Assistentenanweisungen in der Assistants API?
Das Feld für Assistentenanweisungen ist auf 256.000 Zeichen begrenzt.
Ich erhalte eine Fehlermeldung wie „Bei der Verarbeitung deiner Anfrage ist auf dem Server ein Fehler aufgetreten. Das tut uns leid! Du kannst deine Anfrage erneut senden oder uns über unser Hilfecenter auf help.openai.com kontaktieren, wenn der Fehler weiterhin auftritt. “ Was soll ich tun?
Diese Fehlermeldung kann bedeuten, dass dein Prompt nicht richtig aufgebaut ist. Wenn die Anfrage auch nach mehreren Versuchen fehlschlägt, probiere Folgendes:
Strukturiere deinen Prompt so um, dass alle funktionsähnlichen Befehle als Funktionen behandelt werden.
Füge alle Befehle aus deinem Prompt als Funktionen zu tools hinzu.
Warum funktioniert mein Tool File Search nicht gut?
Wenn du das Tool File Search nutzt, empfehlen wir, max_prompt_tokens auf mindestens 20.000 zu setzen. Bei längeren Gesprächen oder mehreren Interaktionen mit File Search solltest du dieses Limit auf 50.000 erhöhen. Für bestmögliche Ergebnisse entfernst du die Begrenzung durch max_prompt_tokens idealerweise ganz.
Wie kann ich Feedback geben?
Wir freuen uns über dein Feedback in unserem Entwicklungsforum, über das Hilfecenter auf help.openai.com oder auf Twitter unter @OpenAIDevs.