Op 11 maart 2025 hebben we de bouwstenen van ons nieuwe Agents-platform uitgebracht. Zie voor details onze API-documentatie voor onze Responses API, Tools waaronder Web Search, File Search en Computer Use, en onze Agents SDK met Tracing. Op basis van jullie feedback op de Assistants API-bèta hebben we belangrijke verbeteringen opgenomen in de Responses API. Zodra we volledige functiepariteit bereiken, kondigen we later dit jaar een uitfaseringsplan voor de Assistants API aan, met als beoogde einddatum de eerste helft van 2026.
Veelgestelde vragen
Wat is de Assistants API?
Met de Assistants API kunnen ontwikkelaars eenvoudig krachtige AI-assistenten bouwen binnen hun apps. Met deze API hoef je de gespreksgeschiedenis niet zelf te beheren en krijg je toegang tot tools die door OpenAI worden gehost, zoals Code-interpreter en File Search. De API biedt ook verbeterde ondersteuning voor functies aanroepen bij tools van derden.
Kan ik Assistants API v1 bèta nog gebruiken?
Nee. Sinds 18 december 2024 hebben gebruikers geen toegang meer tot versie v1 van de bèta van de Assistants API. Momenteel ondersteunen we alleen v2. Lees deze migratiehandleiding om je API-aanroepen van v1 naar v2 om te zetten.
Hoe krijg ik toegang?
De Assistants API is beschikbaar voor iedereen met een OpenAI API-account, maar is verouderd en wordt in augustus 2026 verwijderd. Gebruik voor nieuwe projecten in plaats daarvan de Responses API. Als je de Assistants API al gebruikt, plan dan je migratie naar de Responses API. Je hebt nog steeds toegang tot bestaande assistants in de Assistants Playground zolang de API beschikbaar blijft.
Wat is een assistent?
Een assistent is een AI die voor een specifiek doel is gemaakt en de modellen van OpenAI gebruikt. Een assistent kan bestanden openen, threads bewaren en tools aanroepen.
Wat is een thread?
Een thread is een gesprekssessie tussen een assistent en een gebruiker. Threads vereenvoudigen de ontwikkeling van applicaties door de berichtgeschiedenis op te slaan en in te korten wanneer het gesprek de contextlengte van het model overschrijdt.
Wat is de File Search-tool?
De file_search-tool past standaard verschillende beproefde methoden voor het ophalen van gegevens toe. Zo haal je de juiste gegevens uit je bestanden om de antwoorden van het model aan te vullen.
De file_search-tool gebruikt standaard de volgende instellingen:
Chunkgrootte: 800 tokens
Overlap tussen chunks: 400 tokens
Embeddingmodel: text-embedding-3-large met 256 dimensies
Maximaal aantal chunks dat aan de context wordt toegevoegd: 20
Welke beperkingen gelden voor het uploaden van bestanden?
Voor het uploaden van bestanden gelden de volgende limieten:
512 MB per bestand
5 miljoen tokens per bestand
10.000 bestanden per vectoropslag
1 vectoropslag per assistent
1 vectoropslag per thread
De totale opslaglimiet voor elk project binnen een organisatie is 100 GB.
Wat zijn de beperkingen van de File Search-tool?
Er zijn enkele bekende beperkingen waarvoor we de komende maanden ondersteuning willen toevoegen:
Het is momenteel niet mogelijk om de instellingen voor chunking, embeddings of het ophalen van gegevens aan te passen.
We ondersteunen het analyseren van afbeeldingen in documenten niet.
We ondersteunen het ophalen van gegevens uit gestructureerde bestandsindelingen (zoals .csv- of .jsonl-bestanden) niet. Bekijk de ondersteunde bestandstypen.
Welke aanvraaglimieten gelden voor de Assistants API?
De aanvraaglimieten voor de Assistants API zijn niet gekoppeld aan het gebruiksniveau en model. In plaats daarvan gelden er standaardlimieten per aanvraagtype, met enkele uitzonderingen:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 aanvragen per minuut
Wat kost Code-interpreter in de API?
Code-interpreter kost $ 0,03 per sessie. Als je assistent Code-interpreter tegelijk in twee verschillende threads aanroept, worden er twee Code-interpreter-sessies aangemaakt (2 × $ 0,03). Elke sessie is standaard één uur actief. Je betaalt dit bedrag dus maar één keer als je gebruiker binnen dat uur instructies blijft geven aan Code-interpreter in dezelfde thread.
Wat kost File Search in de API?
File Search kost $ 0,10 per GB vectoropslag per dag (de eerste GB opslag is gratis). De grootte van de vectoropslag wordt bepaald nadat je bestand is geanalyseerd, in chunks is opgedeeld en naar embeddings is omgezet.
Vectoropslag die vóór 17 april 2024 is aangemaakt, blijft gratis tot eind 2024. Daarna geldt een van de volgende opties:
De opslag wordt tegen de geldende tarieven (momenteel $ 0,10/GB/dag) in rekening gebracht als deze minstens één keer is gebruikt in een Run die na 17 april 2024 is aangemaakt.
De opslag wordt verwijderd als deze tussen 17 april 2024 en 31 december 2024 in geen enkele Run is gebruikt. Zo voorkomen we dat je moet betalen voor vectoropslag die je mogelijk vóór de aankondiging van deze prijswijziging hebt aangemaakt, maar nooit hebt gebruikt.
Is er een limiet voor het aantal assistants dat ik kan maken?
Er is geen limiet voor het aantal assistants dat een organisatie kan maken.
Is streaming beschikbaar via de API?
Ja, streaming is beschikbaar via de Assistants API.
Is de JSON-modus beschikbaar in de Assistants API?
Ja, de JSON-modus is beschikbaar in de Assistants API via de parameter response_format op de Assistants- of Run-objecten.
Beheert de Assistants API ook aanvragen voor functieaanroepen naar tools van derden?
Nee. Met functies aanroepen kan het model tools selecteren en aanvragen daarvoor in het juiste formaat opstellen, maar OpenAI beheert de uitvoering van aanroepen naar tools van derden niet.
Hoe wordt er omgegaan met de gegevens die ik naar OpenAI stuur?
Net als op de rest van ons platform worden gegevens en bestanden die naar de OpenAI API worden gestuurd nooit gebruikt om onze modellen te trainen. Je kunt je gegevens op elk moment verwijderen. Gegevens die naar de Assistants API worden geüpload, worden voor onbepaalde tijd bewaard totdat een gebruiker ze handmatig verwijdert.
Is DALL-E beschikbaar via de Assistants API?
DALL-E is momenteel niet beschikbaar.
Is er een UI voor de Assistants API?
Je kunt de Playground voor de Assistants API bekijken. Zorg ervoor dat je in de weergave Assistants in de linkerzijbalk bent en een model gebruikt dat compatibel is met de Tools die je wilt inschakelen.
Wat is de tekenlimiet voor assistentinstructies in de Assistants API?
Het veld voor assistentinstructies heeft een maximale lengte van 256.000 tekens.
Ik krijg een foutmelding zoals "Er is een serverfout opgetreden bij het verwerken van je aanvraag. Onze excuses! Je kunt je aanvraag opnieuw proberen of contact met ons opnemen via ons helpcentrum op help.openai.com als de fout blijft optreden. " Wat moet ik doen?
Als je deze foutmelding krijgt, is je prompt mogelijk niet goed opgesteld. Als de aanvraag na meerdere pogingen blijft mislukken, kun je het volgende proberen:
herstructureer je prompt zodat opdrachten die op functies lijken ook als functies worden behandeld
voeg alle opdrachten in je prompt als functie toe aan tools
Waarom werkt mijn File Search-tool niet goed?
Als je de File Search-tool gebruikt, raden we aan max_prompt_tokens in te stellen op minimaal 20.000. Overweeg bij langere gesprekken of meerdere interacties met File Search deze limiet te verhogen naar 50.000. Voor de beste resultaten kun je de limiet voor max_prompt_tokens het beste helemaal verwijderen.
Hoe kan ik feedback geven?
We horen graag je feedback op ons ontwikkelaarsforum, via het helpcentrum op help.openai.com of op Twitter via @OpenAIDevs.