Comment intégrer l’API OpenAI à votre app

Pour intégrer l’API OpenAI, créez une clé API dans un projet OpenAI, conservez-la comme secret côté serveur nommé OPENAI_API_KEY, et appelez l’API depuis une route de votre propre serveur à l’aide du SDK officiel d’OpenAI, jamais depuis du code de navigateur. En date de septembre 2026, le démarrage rapide d’OpenAI présente l’API Responses comme point de départ pour les nouveaux projets. Fixez un plafond de dépenses avant le lancement, limitez la longueur des réponses, restreignez la fréquence à laquelle chaque utilisateur peut appeler la fonction, et gérez les erreurs de limite de débit avec des nouvelles tentatives.

Ce guide couvre la configuration, le flux de requête, des consignes pour un créateur d’IA et les erreurs qui fuient les clés ou font exploser les coûts. Les détails d’OpenAI proviennent de sa documentation officielle en date de septembre 2026. Pour les concepts généraux (jetons, fenêtres de contexte, tarification), lisez d’abord comment utiliser les API de LLM.

Ce que vous pouvez construire avec

• Un assistant conversationnel dans votre app (comment créer une app de chatbot IA)
• Des boutons « Résumer ceci », « Réécrire ceci » ou « Rédiger une réponse »
• L’extraction de données structurées à partir de texte libre : transformer un courriel en commande, classer des billets de soutien
• La recherche et les réponses aux questions à partir de votre propre contenu
• La génération d’images, la voix et d’autres fonctions multimédias, selon les modèles disponibles

D’autres idées sont présentées dans comment ajouter des fonctions d’IA à votre app.

Configurer votre compte OpenAI

1. Créez un compte et un projet sur la plateforme OpenAI. Les meilleures pratiques de production d’OpenAI recommandent des projets distincts pour la préproduction et la production, afin que chacun ait ses propres clés et limites.
2. Créez une clé API de projet. OpenAI recommande de définir une date d’expiration et de renouveler les clés régulièrement.
3. Définissez des alertes de dépenses et un plafond strict dans la page des limites. Le guide d’OpenAI indique que les alertes vous avertissent lorsque l’utilisation dépasse un montant, et qu’un plafond strict impose une limite mensuelle.
4. Ajoutez un mode de paiement. La documentation d’OpenAI sur les limites de débit décrit des niveaux d’utilisation : vos limites augmentent automatiquement à mesure que vous dépensez davantage au fil du temps.

Le flux de requête

Navigateur  ->  route de votre serveur  ->  API OpenAI
            <-  réponse (diffusée)    <-

1. L’utilisateur clique sur un bouton ou envoie un message.
2. Le navigateur appelle votre route, par exemple POST /api/summarise.
3. Votre serveur vérifie que l’utilisateur est connecté et autorisé à utiliser la fonction.
4. Le serveur construit la requête : consignes, entrée de l’utilisateur et toute donnée de votre base de données dont la tâche a besoin.
5. Il appelle OpenAI avec la clé provenant de l’environnement. Les SDK d’OpenAI lisent OPENAI_API_KEY automatiquement.
6. Il diffuse ou renvoie la réponse, et journalise l’utilisation des jetons.

Le SDK officiel d’OpenAI s’appelle openai, pour JavaScript/TypeScript (npm) comme pour Python (pip).

Choisir un modèle

OpenAI propose plusieurs modèles à différents prix et vitesses, et la gamme change souvent. Commencez avec un modèle plus petit et moins cher, mesurez la qualité sur de vrais exemples, et passez à un modèle supérieur seulement si vous en avez besoin. Conservez le nom du modèle dans une valeur de configuration ou un secret pour pouvoir le changer sans réécrire le code. Consultez la page de tarification d’OpenAI pour les tarifs actuels.

Options et compromis

Consignes à donner à votre créateur d’IA

Une première fonction :

Ajoute un bouton « Résumer » sur la page du billet. Il appelle une route serveur POST /api/summarise qui vérifie que l’utilisateur est connecté, charge le billet et appelle l’API Responses d’OpenAI avec le SDK officiel openai et le secret OPENAI_API_KEY. Lis le nom du modèle dans le secret OPENAI_MODEL. Consignes : « Résume en 3 puces, puis suggère une courte réponse. N’invente pas de numéros de commande. » Limite la longueur de la sortie, diffuse la réponse dans la page, et n’envoie jamais la clé au navigateur.

Garde-fous :

Limite chaque utilisateur à 30 requêtes d’IA par heure, stockées dans la base de données. Journalise les jetons d’entrée et de sortie de chaque requête avec l’identifiant de l’utilisateur et le nom de la fonction. Si OpenAI renvoie une erreur 429, respecte l’en-tête Retry-After, réessaie avec un délai exponentiel et une gigue, jusqu’à 3 fois; après cela, affiche « L’IA est occupée, réessayez dans une minute. » Affiche un message d’erreur convivial pour tout autre échec et garde le reste de la page fonctionnel.

Gérer les erreurs et les limites

OpenAI mesure les limites de débit de plusieurs façons, dont les requêtes par minute et les jetons par minute, et vous atteignez celle qui s’épuise en premier. Lorsque vous dépassez l’une d’elles, l’API renvoie une erreur 429 avec un en-tête Retry-After. La documentation d’OpenAI indique de traiter cette valeur comme un minimum et d’ajouter un petit délai aléatoire, pour que les clients ne réessaient pas tous en même temps.

Prévoyez aussi :

• Des délais d’attente pour les longues générations. La diffusion aide, tout comme un plafond raisonnable de sortie.
• Des pannes du fournisseur. La fonction d’IA devrait échouer en douceur sans briser la page.
• Des résultats inadéquats. Validez la sortie structurée avant de l’enregistrer, et ne laissez pas une sortie du modèle déclencher une action sensible sans vérification dans votre code.

Erreurs courantes

• Clé dans l’interface ou dans le dépôt. Le code du navigateur est public, et une clé divulguée peut être utilisée à mauvais escient en quelques minutes. Consultez comment protéger vos clés API.
• Aucun plafond de dépenses. Une boucle ou un utilisateur abusif peut faire grimper rapidement la facture.
• Aucune limite par utilisateur. La limite de votre fournisseur protège votre portefeuille, pas vos autres utilisateurs.
• Faire confiance à la consigne pour la sécurité. Les utilisateurs peuvent taper « ignore les instructions précédentes ». Les autorisations doivent se trouver dans le code serveur.
• Envoyer plus que nécessaire. Les documents complets et les longs historiques multiplient les coûts. Envoyez ce dont la tâche a besoin.
• Coder en dur le nom du modèle. Les modèles sont mis à jour et retirés; faites-en un paramètre.
• Envoyer des données personnelles sans réfléchir. Lisez les conditions d’utilisation des données d’OpenAI et n’envoyez que ce dont la fonction a besoin.

Liste de vérification

• Projets OpenAI (ou clés) distincts pour les tests et la production
• Clé conservée comme secret côté serveur, jamais dans le code du navigateur ou le dépôt
• Alertes de dépenses et plafond strict définis
• Tous les appels passent par votre serveur et vérifient les autorisations de l’utilisateur
• Longueur de sortie limitée; nom du modèle configurable
• Limite de débit par utilisateur dans votre app
• Gestion des erreurs 429 avec Retry-After, délai exponentiel et gigue
• État d’erreur convivial; la page fonctionne sans l’IA
• Utilisation des jetons journalisée par fonction
• Testé avec des entrées longues, vides et hostiles

Utiliser l’API OpenAI dans Mythex

Les fonctions d’IA dans les apps que vous construisez sur Mythex utilisent votre propre clé OpenAI, facturée à votre compte OpenAI et non aux crédits de construction Mythex. Ajoutez OPENAI_API_KEY comme secret de projet via /secrets, les paramètres du projet ou la carte de secrets que l’agent affiche lorsqu’il a besoin d’une clé, puis décrivez la fonction avec une consigne semblable à celles ci-dessus. Après avoir modifié les secrets d’une app publiée, publiez de nouveau pour qu’elle les prenne en compte. Le guide Ajouter des fonctions d’IA avec vos propres clés API propose une consigne de départ, et Secrets dans le clavardage explique la carte de secrets. Vous comparez les fournisseurs? Consultez comment intégrer l’API Claude.

Questions