Configuration de l'API Astra avec l'authentification OpenAI officielle

Commencez par le fournisseur et le compte de facturation

Utilisez gpt-6-astra via l'API OpenAI avec votre propre clé OpenAI Platform. Pour une application, commencez par l'exemple Responses ci-dessous. Pour le codage local, utilisez les commandes de connexion et de sélection du modèle du CLI Codex. Les deux chemins utilisent votre compte Platform et entraînent des frais API aux tarifs OpenAI applicables.

Avant d'exécuter une requête, confirmez qui possède le projet Platform, si sa clé peut accéder au modèle et quels contrôles de facturation s'appliquent. La présence d'un modèle dans ChatGPT ou Codex n'accorde pas l'accès à tous les projets API. Gardez séparées la connexion par abonnement et la connexion par clé API dans vos notes d'exécution. Cette distinction est essentielle pour diagnostiquer ultérieurement une limite ou rapprocher des frais.

Préparez la clé et le client dans un environnement de confiance

Créez une clé API dans le tableau de bord OpenAI et fournissez-la sous le nom OPENAI_API_KEY via votre environnement privé ou votre gestionnaire de secrets. Le SDK officiel lit cette variable. N'intégrez jamais la clé dans du JavaScript navigateur, un dépôt public, une capture d'écran ou une transcription de terminal partagée. Évitez le traçage du shell pendant la manipulation des identifiants.

Pour l'exemple JavaScript ci-dessous, installez le paquet officiel openai dans votre projet avec npm install openai. Enregistrez la version installée dans votre lockfile. Le baseURL explicite sélectionne OpenAI plutôt qu'un endpoint personnalisé hérité. Examinez aussi la configuration existante de l'agent : un remplacement de fournisseur et un identifiant provenant d'un autre service ne deviennent pas compatibles simplement parce qu'ils acceptent tous deux un en-tête Authorization.

Envoyez une requête Responses et lisez la réponse

Créez astra-example.mjs avec le code suivant, puis exécutez node astra-example.mjs. Le prompt demande une courte checklist afin que vous puissiez inspecter la réponse renvoyée avant de connecter un workflow plus large. Les nouvelles tentatives automatiques du SDK sont désactivées pour cette première requête, ce qui facilite le diagnostic des erreurs de connexion ou de compte.

Lorsque le statut est completed, response.output_text contient la sortie texte combinée du SDK. Affichez-la sur la sortie standard afin qu'un autre programme puisse la consommer ou la rediriger vers un fichier. Envoyez les métadonnées de réponse sur la sortie d'erreur standard pour les séparer de la réponse. Pour les réponses incomplètes, conservez incomplete_details et usage et renvoyez un code de sortie non nul.

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.openai.com/v1',
  maxRetries: 0,
})
const response = await client.responses.create({
  model: 'gpt-6-astra',
  input: 'List three checks for a small code change.',
})
console.error(JSON.stringify({
  id: response.id,
  model: response.model,
  status: response.status,
  usage: response.usage,
  incomplete_details: response.incomplete_details,
}))
if (response.status === 'completed') {
  console.log(response.output_text)
} else {
  process.exitCode = 1
}

Sélectionnez l'authentification par clé API pour Codex local

OpenAI documente la connexion par clé API pour le travail local avec Codex. Dans le CLI, consultez l'état de connexion Codex avant de modifier les identifiants. La commande stdin documentée ci-dessous évite de coller un secret dans un argument de commande. Après la connexion, vérifiez encore la méthode d'authentification active, puis sélectionnez le modèle exact avec l'option de modèle du CLI.

La commande finale ouvre une session interactive avec Astra sélectionné. Commencez dans le répertoire de votre projet afin que l'agent puisse lire les bons fichiers et les instructions du dépôt. Examinez les remplacements de fournisseur existants et confirmez le compte actif. Le mode par clé API prend en charge le travail local ; Codex cloud exige l'authentification ChatGPT. Pour une tâche cloud que vous souhaitez poursuivre localement, apportez d'abord les fichiers de travail et un bref résumé du travail restant dans votre projet local.

codex login status
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status
codex --model gpt-6-astra

Faites correspondre les capacités au chemin client

Astra prend en charge Responses et Chat Completions, mais l'appel d'outils exige Responses. Utilisez Responses pour un agent qui exécute des fonctions ou des outils personnalisés. Un client conçu pour lire des choix de chat ne peut pas analyser une sortie Responses en changeant seulement l'URL, et un smoke test textuel n'exerce pas une boucle d'outils.

Ajoutez une capacité à la fois avec un petit exemple de votre application. Pour les outils, validez les arguments, exécutez la fonction dans votre application et renvoyez le résultat via Responses avec le call_id correspondant. Pour la sortie structurée, validez le schéma et gérez les réponses incomplètes. Pour le streaming, traitez les événements d'achèvement et d'annulation ainsi que le texte. Gardez la simple requête texte disponible comme chemin de diagnostic pendant l'ajout de ces fonctions.

Diagnostiquez séparément les échecs d'accès, de débit et d'achèvement

Utilisez le statut HTTP et les champs d'erreur structurés avant de réessayer. Le guide des erreurs d'OpenAI distingue l'authentification invalide, les crédits épuisés, les limites de dépense imposées et la pression sur le débit des requêtes. En particulier, une réponse 429 ne suffit pas à choisir un remède : inspectez error.code et les paramètres pertinents du compte.

En cas de pression temporaire sur le débit, respectez Retry-After lorsqu'il est présent et utilisez des tentatives limitées. Les échecs de facturation ou de limite de dépense exigent une décision sur le compte, et non des requêtes répétées. Une réponse Responses marquée incomplete est encore une condition différente et peut déjà avoir consommé des tokens. Conservez les informations d'erreur et l'utilisation après masquage ; ne transformez pas un délai d'attente ou un reçu manquant en tentative réussie ou gratuite.

Disponibilité du fournisseur et preuves : 5 septembre 2026

OpenAI a annoncé GPT-6 Astra selon un déploiement progressif et sa référence du modèle documente l'API officielle. Les exemples présentés suivent ces sources ; aucune requête payante ni aucun changement d'authentification Codex n'a été exécuté pour ce guide. Le contrôle du catalogue public APIsRouter du 5 septembre 2026 a renvoyé HTTP 200, success: true et 34 modèles, sans entrée Astra ni GPT-6.

Utilisez les identifiants OpenAI uniquement avec l'endpoint officiel indiqué ci-dessus. Vérifiez le catalogue APIsRouter en direct pour ses propres offres. Une inscription Astra ultérieure nécessiterait encore la vérification de son identifiant exact, de son prix et des fonctionnalités client requises avant son utilisation dans votre application.

Reliez la réponse à un workflow local utile

Choisissez une tâche locale avec un résultat concret, comme expliquer une fonction et proposer un test. Donnez à l'agent le chemin du fichier concerné, le comportement attendu et la commande de test. Après une modification de code, inspectez le diff et exécutez les tests ciblés. Gardez l'entrée originale et la réponse renvoyée ensemble afin de comparer facilement les révisions.

Dans une application, transmettez le texte terminé à votre écran de revue ou à votre pipeline documentaire. Si l'étape suivante attend des données lisibles par machine, utilisez une sortie structurée et validez les champs requis avant de les stocker. Conservez l'identité de la requête et l'utilisation à côté de la tâche et définissez une politique de nouvelles tentatives limitée. Étendez le workflow après avoir fait fonctionner ensemble ses contrôles d'entrée, de gestion de réponse et d'achèvement de base.

Questions fréquentes