Que peut faire votre logiciel avec l'API d'OpenAI ?
L'API d'OpenAI fonctionne en requête et réponse : votre logiciel envoie une demande à un point d'accès, avec la clé d'API dans l'en-tête Authorization (jeton Bearer), et reçoit le résultat. Les points d'accès utiles à un logiciel de gestion sont peu nombreux.
| Point d'accès | Usage dans un logiciel métier |
|---|---|
| /v1/responses (Responses API) | Lire un courriel ou un PDF, extraire des champs, rédiger un brouillon, appeler des fonctions de votre logiciel (outils) |
| /v1/chat/completions | Autre point d'accès de génération de texte, toujours pris en charge |
| /v1/embeddings | Transformer des textes en vecteurs pour retrouver les passages proches d'une question |
| /v1/moderations | Filtrer les contenus déposés par des utilisateurs |
| /v1/batches et /v1/files | Envoyer un fichier de milliers de requêtes à traiter de façon asynchrone |
Pour obtenir des données exploitables plutôt que du texte libre, la Responses API accepte un format de sortie json_schema en mode strict. Selon la documentation d'OpenAI, ces Structured Outputs assurent que la réponse respecte toujours le schéma fourni, alors que le mode JSON assure seulement un JSON valide. Les refus du modèle restent détectables par programme. Enfin, des webhooks préviennent votre serveur quand un traitement long se termine : lot terminé, réponse générée en arrière-plan, entraînement achevé.
Quelles limites et quels plafonds de dépense ?
OpenAI limite l'usage selon cinq unités : requêtes par minute et par jour, jetons par minute et par jour, images par minute. Ces limites s'appliquent à l'organisation et au projet, varient selon le modèle, et la première atteinte bloque. Le niveau du compte dépend du total des crédits achetés.
| Niveau | Condition | Usage mensuel maximal |
|---|---|---|
| Free | Être dans une zone géographique autorisée | 100 dollars |
| Build | 5 dollars de crédits achetés au total | 500 dollars |
| Launch | 100 dollars au total | 5 000 dollars |
| Grow | 500 dollars au total | 200 000 dollars |
Valeurs publiées par OpenAI, relevées en octobre 2026. Un dépassement renvoie une erreur HTTP 429 ; les en-têtes x-ratelimit indiquent le quota restant et le délai de réinitialisation, et l'en-tête Retry-After, quand il est présent, donne l'attente minimale. OpenAI recommande de réessayer avec un délai exponentiel et une part d'aléatoire, de plafonner le nombre de tentatives et de ne pas réessayer une erreur de quota ou de facturation. Le prix des jetons eux-mêmes est détaillé sur notre page prix d'une API d'intelligence artificielle.
Que deviennent les données envoyées à OpenAI ?
- Entraînement : depuis le 1er mars 2023, les données transmises à l'API ne servent pas à entraîner ou améliorer les modèles d'OpenAI, sauf partage explicitement accepté.
- Journaux de surveillance des abus : générés par défaut et conservés jusqu'à 30 jours, ils peuvent contenir les requêtes et les réponses.
- Données applicatives : les réponses stockées par la Responses API sont gardées 30 jours par défaut ; fichiers, lots et bases vectorielles restent jusqu'à leur suppression.
- Rétention zéro : les options Zero Data Retention et Modified Abuse Monitoring retirent le contenu des journaux d'abus. Elles sont soumises à l'approbation préalable d'OpenAI.
- Europe : la résidence des données se règle par projet, sur le point d'accès eu.api.openai.com. Elle exige une approbation, l'une des deux options précédentes, et une majoration de 10 % s'applique à certains modèles sortis depuis le 5 mars 2026. Les données de compte et de facturation ne sont pas couvertes.
Côté RGPD, la règle de prudence reste la minimisation : on retire du texte envoyé ce qui n'est pas nécessaire à la tâche, et le traitement est inscrit au registre avec son sous-traitant.
Quatre intégrations OpenAI typiques en PME
- Les bons de commande reçus par courriel. Un client envoie son bon en PDF. Le logiciel transmet le document avec un schéma (client, références, quantités, date souhaitée) ; la réponse structurée est contrôlée contre le catalogue, puis une commande brouillon attend la validation de l'ADV. La démarche complète figure sur notre page pour automatiser la saisie avec l'IA.
- Le tri des demandes entrantes. Chaque message du formulaire de contact reçoit une catégorie et un niveau d'urgence, puis part vers la bonne file : devis, SAV, réclamation. Une personne corrige les erreurs de tri, qui servent ensuite à améliorer les consignes.
- La reprise d'un catalogue la nuit. Vingt mille fiches produits doivent être normalisées. Le logiciel prépare un fichier JSONL, une ligne par fiche avec un identifiant custom_id, et l'envoie à la Batch API ; le webhook de fin de lot déclenche l'import, chaque résultat étant rapproché de sa fiche par cet identifiant.
- La question posée à la documentation interne. Procédures et notices sont découpées et indexées par embeddings ; le technicien pose sa question, le logiciel retrouve les passages pertinents et le modèle répond en citant le document source. Ce type d'assistant est décrit sur notre page assistants et agents IA.
Les étapes d'une intégration OpenAI bien menée
- Un jeu d'essai réel : cinquante à cent cas anonymisés tirés de votre activité, avec la réponse attendue, avant toute ligne de code.
- Des projets séparés : OpenAI suggère des projets distincts pour la préproduction et la production, avec un accès restreint au projet de production et des limites de débit et de dépense propres à chacun.
- Des clés de projet à durée limitée : OpenAI recommande fortement une date d'expiration et une rotation régulière, avec des clés passées par variables d'environnement ou coffre de secrets, jamais dans le code ni dans un dépôt public.
- Des consignes et des schémas versionnés, rangés avec le code, pour savoir quelle version a produit quel résultat.
- Une évaluation chiffrée sur le jeu d'essai, refaite à chaque changement de modèle ou de consigne.
- Une mise en service sous contrôle humain, puis un suivi de la qualité, du coût et du temps de réponse.
Erreurs, doublons, hallucinations : ce qu'il faut prévoir
- Le modèle peut se tromper avec aplomb : une hallucination ne déclenche aucune erreur technique. Toute donnée extraite est vérifiée par des règles (la référence existe, la quantité est plausible) et rien n'entre en comptabilité sans validation.
- Le webhook peut arriver deux fois : OpenAI l'indique et relance les livraisons échouées jusqu'à 72 heures avec un délai croissant. Le serveur vérifie la signature (en-têtes webhook-id, webhook-timestamp, webhook-signature) sur le corps brut, répond vite en 2xx, puis traite en arrière-plan en ignorant un webhook-id déjà vu.
- Le lot peut expirer : un lot non terminé en 24 heures passe au statut expired ; les requêtes manquantes sont renvoyées dans un nouveau lot.
- La dépense peut s'emballer : un plafond de dépense strict coupe le trafic quand il est atteint, ce qui protège le budget mais arrête le service ; on le règle en connaissance de cause.
- La clé ne va jamais dans le navigateur ni dans l'application mobile : les appels passent par votre serveur.
ChatGPT, outil d'automatisation ou intégration sur mesure ?
Si le besoin est d'aider chaque salarié à rédiger ou à résumer, une offre d'assistant prête à l'emploi suffit souvent ; notre comparatif ChatGPT Enterprise ou assistant sur mesure aide à trancher. L'intégration par l'API se justifie quand l'IA doit agir dans un flux du logiciel métier, sur vos données, avec contrôle et traçabilité.
Dans ce cas, YMHB Web ouvre l'organisation et les projets OpenAI au nom du client, livre le code dans son dépôt avec les consignes, les schémas et le jeu d'essai, et isole l'appel au modèle derrière une couche commune : passer à Claude d'Anthropic ou à Mistral AI se teste alors sans réécrire le logiciel.
Questions fréquentes
OpenAI utilise-t-il les données envoyées par notre logiciel pour entraîner ses modèles ?
Non, pas par défaut. Selon la documentation d'OpenAI, les données envoyées à l'API ne servent pas à entraîner ni à améliorer ses modèles depuis le 1er mars 2023, sauf si le client accepte explicitement de les partager. Elles peuvent en revanche figurer dans des journaux de surveillance des abus conservés jusqu'à 30 jours, sauf option de rétention zéro approuvée par OpenAI.
Peut-on faire traiter les données par OpenAI en Europe ?
Oui, sous conditions. OpenAI propose une résidence des données en Europe, réglée projet par projet, sur le point d'accès eu.api.openai.com. Elle demande de vérifier son éligibilité auprès des équipes commerciales d'OpenAI, d'avoir obtenu la rétention zéro ou la surveillance d'abus modifiée, et entraîne une majoration de 10 % sur certains modèles récents. Les données de compte et de facturation restent hors de ce périmètre.
Que faire quand l'API OpenAI renvoie une erreur 429 ?
Une erreur 429 signifie qu'une limite de débit ou de dépense est atteinte. OpenAI recommande de réessayer avec un délai exponentiel et une part d'aléatoire, en respectant l'en-tête Retry-After quand il est présent, et en plafonnant les tentatives. Une erreur de quota ou de facturation ne se règle pas en réessayant : elle demande une action sur le compte. Pour les gros volumes non urgents, la Batch API dispose de ses propres limites, distinctes de celles des appels synchrones.
Comment obtenir des données fiables plutôt que du texte libre avec OpenAI ?
Avec les Structured Outputs, le logiciel fournit un schéma JSON (champs, types, valeurs autorisées) et la documentation d'OpenAI indique que la réponse respecte toujours ce schéma, contrairement au simple mode JSON. La conformité du format ne garantit pas l'exactitude du contenu : chaque valeur extraite reste contrôlée par des règles métier et, pour les flux sensibles, validée par une personne.
Faut-il garder la clé d'API OpenAI dans l'application mobile ?
Non. La documentation d'OpenAI demande de ne pas exposer les clés dans le code ni dans des dépôts publics, et de les fournir à l'application par des variables d'environnement ou un service de gestion de secrets. Une application mobile ou un site appelle donc votre serveur, qui seul détient la clé, applique les droits de l'utilisateur et journalise l'appel.
À lire aussi
Sources
- OpenAI, API Docs : Rate limits (unités, niveaux Free, Build, Launch, Grow, erreurs 429, en-têtes, Batch API ; relevé en octobre 2026)
- OpenAI, API Docs : Data controls in the OpenAI platform (entraînement, surveillance des abus, rétention, résidence des données)
- OpenAI, API Docs : Batch API (JSONL, custom_id, 24 heures, 50 000 requêtes, 50 % de réduction, statuts)
- OpenAI, API Docs : Webhooks (Standard Webhooks, signature, relances pendant 72 heures, webhook-id)
- OpenAI, API Docs : Structured Outputs (json_schema, mode strict, différence avec le mode JSON)
- OpenAI, API Docs : Production best practices (clés, projets, limites par projet, plafonds de dépense)
