Au 11 mars 2025, nous avons publié les éléments de base de notre nouvelle plateforme Agents. Pour plus de détails, consultez notre documentation API pour notre API Responses, les outils comprenant Web Search, File Search et Computer Use, ainsi que notre SDK Agents avec Tracing. Sur la base de vos retours sur la version bêta de l’API Assistants, nous avons intégré des améliorations clés dans l’API Responses. Une fois la parité complète des fonctionnalités atteinte, nous annoncerons un plan d’abandon de l’API Assistants plus tard cette année, avec une date cible de fin de prise en charge au premier semestre 2026.
FAQ
Qu’est-ce que l’API Assistants ?
L’API Assistants permet aux développeurs de créer facilement de puissants assistants IA au sein de leurs applications. Cette API évite d’avoir à gérer l’historique des conversations et donne accès à des outils hébergés par OpenAI, comme l’Interpréteur de code et la recherche de fichiers. L’API prend également en charge un mécanisme amélioré d’appel de fonction pour les outils tiers.
Puis-je encore utiliser la version bêta v1 de l’API Assistants ?
Non. Depuis le 18 décembre 2024, les utilisateurs n’ont plus accès à la version v1 bêta de l’API Assistants. Nous ne prenons actuellement en charge que la v2. Consultez ce guide de migration pour convertir vos appels d’API de la v1 vers la v2.
Comment y accéder ?
L’API Assistants est disponible pour toute personne disposant d’un compte API OpenAI, mais elle est obsolète et sera supprimée en août 2026. Pour les nouveaux projets, utilisez plutôt l’API Responses. Si vous utilisez déjà l’API Assistants, planifiez votre migration vers l’API Responses. Vous pouvez toujours accéder aux assistants existants dans l’Assistants Playground tant que l’API reste disponible.
Qu’est-ce qu’un assistant ?
Un assistant est une IA conçue pour un usage précis, qui utilise les modèles d’OpenAI et peut accéder à des fichiers, conserver des fils de discussion persistants et appeler des outils.
Qu’est-ce qu’un fil de discussion ?
Un fil de discussion est une session de conversation entre un assistant et un utilisateur. Les fils de discussion simplifient le développement d’applications en stockant l’historique des messages et en le tronquant lorsque la conversation dépasse la longueur du contexte du modèle.
Qu’est-ce que l’outil de recherche de fichiers ?
L’outil file_search intègre plusieurs bonnes pratiques de récupération pour vous aider à extraire les données pertinentes de vos fichiers afin d’enrichir les réponses du modèle.
Par défaut, l’outil file_search utilise les paramètres suivants :
Taille des fragments : 800 tokens
Chevauchement des fragments : 400 tokens
Modèle de vectorisation : text-embedding-3-large à 256 dimensions
Nombre maximal de fragments ajoutés au contexte : 20
Quelles sont les restrictions pour l’importation de fichiers ?
Les restrictions pour l’importation d’un fichier sont les suivantes :
512 Mo par fichier
5 millions de tokens par fichier
10 000 fichiers par base vectorielle
1 base vectorielle par assistant
1 base vectorielle par fil de discussion
La limite de stockage totale pour chaque projet d’une organisation est de 100 Go.
Quelles sont les limites de l’outil de recherche de fichiers ?
Voici quelques limites connues que nous nous efforçons de lever dans les mois à venir :
Il n’est actuellement pas possible de modifier les paramètres de découpage, de vectorisation ou de récupération.
Nous ne prenons pas en charge l’analyse des images contenues dans les documents.
Nous ne prenons pas en charge la récupération de données dans les fichiers structurés (comme les fichiers .csv ou .jsonl). Consultez les types de fichiers pris en charge.
Quelles sont les limites de débit de l’API Assistants ?
Les limites de débit de l’API Assistants ne dépendent pas du niveau d’utilisation ni du modèle. Des limites par défaut s’appliquent plutôt par type de requête, avec quelques exceptions :
GET : 1 000 requêtes par minute
POST : 300 requêtes par minute
DELETE : 300 requêtes par minute
Quelle est la tarification de l’Interpréteur de code dans l’API ?
L’Interpréteur de code est facturé 0,03 $ par session. Si votre assistant appelle l’Interpréteur de code simultanément dans deux fils de discussion différents, cela crée deux sessions de l’Interpréteur de code (2 × 0,03 $). Chaque session est active par défaut pendant une heure. Ces frais ne vous sont donc facturés qu’une seule fois si votre utilisateur continue de donner des instructions à l’Interpréteur de code dans le même fil de discussion pendant cette heure.
Quelle est la tarification de la recherche de fichiers dans l’API ?
La recherche de fichiers est facturée 0,10 $ par Go de stockage en base vectorielle et par jour (le premier Go de stockage est gratuit). La taille de la base vectorielle est calculée une fois votre fichier analysé, découpé et vectorisé.
Les bases vectorielles créées avant le 17 avril 2024 seront gratuites jusqu’à la fin de l’année 2024, après quoi elles seront :
Facturées aux tarifs en vigueur (actuellement 0,10 $/Go/jour) si elles ont été utilisées au moins une fois dans un Run créé après le 17 avril 2024.
Supprimées si elles n’ont été utilisées dans aucun Run entre le 17 avril 2024 et le 31 décembre 2024, afin d’éviter de vous facturer des bases vectorielles que vous auriez créées avant l’annonce de ce changement de tarification, mais jamais utilisées.
Existe-t-il une limite au nombre d’assistants que je peux créer ?
Il n’y a pas de limite au nombre d’assistants qu’une organisation peut créer.
Le streaming est-il disponible dans l’API ?
Oui, le streaming est disponible dans l’API Assistants.
Le mode JSON est-il disponible dans l’API Assistants ?
Oui, le mode JSON est disponible dans l’API Assistants via le paramètre response_format des objets Assistants ou Run.
L’API Assistants gérera-t-elle aussi les requêtes d’appel de fonction pour les outils tiers ?
Non. L’appel de fonction permet au modèle de sélectionner des outils et de formater les requêtes qui leur sont destinées, mais l’exécution des appels aux outils tiers n’est pas gérée par OpenAI.
Comment les données que j’envoie à OpenAI sont-elles traitées ?
Comme sur le reste de notre plateforme, les données et fichiers transmis à l’API OpenAI ne sont jamais utilisés pour entraîner nos modèles, et vous pouvez supprimer vos données à tout moment. Les données importées dans l’API Assistants sont conservées indéfiniment jusqu’à ce qu’un utilisateur les supprime manuellement.
DALL-E est-il disponible via l’API Assistants ?
Pour le moment, DALL-E n’est pas disponible.
Existe-t-il une interface utilisateur pour l’API Assistants ?
Vous pouvez consulter le Playground pour l’API Assistants. Assurez-vous d’être dans la vue Assistants de la barre latérale gauche et d’utiliser un modèle compatible avec les outils que vous souhaitez activer.

Quelle est la limite de caractères pour les instructions de l’assistant dans l’API Assistants ?
Le champ des instructions de l’assistant est limité à 256 000 caractères.
Je reçois une erreur du type « Le serveur a rencontré une erreur lors du traitement de votre requête. Nous en sommes désolés ! Vous pouvez réessayer votre requête ou nous contacter via notre centre d’aide à l’adresse help.openai.com si l’erreur persiste. » Que dois-je faire ?
Si vous recevez cette erreur, cela peut signifier que votre prompt n’est pas correctement configuré. Si votre requête échoue malgré plusieurs tentatives, voici quelques pistes à essayer :
restructurez votre prompt pour traiter comme des fonctions toutes les commandes qui s’y apparentent
ajoutez chaque commande de votre prompt à tools sous forme de fonction
Pourquoi mon outil de recherche de fichiers fonctionne-t-il mal ?
Lorsque vous utilisez l’outil de recherche de fichiers, nous recommandons de définir max_prompt_tokens sur une valeur d’au moins 20 000. Pour les conversations plus longues ou les interactions multiples avec la recherche de fichiers, envisagez d’augmenter cette limite à 50 000 ou, idéalement, de supprimer entièrement les limites max_prompt_tokens afin d’obtenir les meilleurs résultats.
Comment puis-je faire part de mes commentaires ?
Nous serions ravis de recevoir vos commentaires sur notre forum des développeurs, via le centre d’aide à l’adresse help.openai.com, ou sur Twitter @OpenAIDevs.
