Le SDK officiel utilise la Responses API pour les nouveaux développements. L’appel doit rester côté serveur : une clé intégrée au navigateur devient publique.
Installer
~~~bash mkdir openai-node && cd openai-node npm init -y npm install openai dotenv ~~~
Créez .env puis ajoutez-le à .gitignore :
~~~text OPENAI_API_KEY=votre_cle OPENAI_MODEL=un_modele_actif ~~~
Envoyer une requête
~~~javascript import 'dotenv/config'; import OpenAI from 'openai';
const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const response = await client.responses.create({ model: process.env.OPENAI_MODEL, instructions: 'Réponds clairement en français.', input: 'Explique une API REST en trois phrases.', max_output_tokens: 250, });
console.log(response.output_text); console.log(response.id, response.usage); ~~~
Lancez node index.mjs. Utilisez un identifiant présent dans le catalogue actuel plutôt qu’un nom copié dans un ancien tutoriel.
Ajouter une entrée structurée
La propriété input peut recevoir une liste de messages et de contenus multimodaux. Séparez les instructions de l’entrée utilisateur. Ne concaténez pas une donnée non fiable dans une instruction système.
Gérer les erreurs
~~~javascript try { const response = await client.responses.create({ /* ... */ }); } catch (error) { console.error(error.status, error.request_id, error.message); process.exitCode = 1; } ~~~
Ajoutez timeout applicatif et relance exponentielle seulement pour les erreurs temporaires. Journalisez l’identifiant de requête, pas la clé ni le prompt sensible.
Production
Bornez l’entrée et la sortie, authentifiez votre endpoint, appliquez quotas et budget par utilisateur. Conservez modèle, version de prompt, latence et tokens. Avant de changer de modèle, exécutez un jeu de tests métier.
FAQ
Pourquoi output_text ?
C’est un helper qui agrège les blocs textuels de la réponse. Inspectez output lorsque vous utilisez outils ou contenus multiples.
Peut-on appeler OpenAI depuis React ?
Passez par une route serveur ou une Server Action protégée ; n’exposez pas la clé au client.