Passer au contenu principal
Créez une clé API, envoyez une requête à POST /v1/responses et lisez la réponse dans output_text.

Commencer avec votre agent de code

Copiez ce prompt dans votre agent de code. Il identifie le langage de votre projet, installe le SDK, oriente l’agent vers la documentation Phaseo, garde votre clé hors du code et envoie une première requête. Si votre projet utilise déjà Phaseo, il vérifie plutôt la configuration existante. phaseo/free fonctionne sans crédits ; remplacez-le par n’importe quel ID de modèle de texte depuis Modèles.

Prompt de configuration pour votre agent de code. Copiez-le ou ouvrez-le dans Cursor.

Ouvrir dans Cursor
Pour tout configurer vous-même, suivez les étapes ci-dessous.

1. Créer une clé API

Créez une clé dans le tableau de bord, sous Paramètres -> Clés API, puis exportez-la :
La clé ne s’affiche qu’une seule fois. Chaque requête l’envoie comme jeton bearer :
Traitez votre clé API comme un mot de passe. Gardez-la dans du code côté serveur et ne l’intégrez jamais à un navigateur ou à une application mobile.

Ajouter des crédits pour les modèles payants

phaseo/free fonctionne sans crédits. Les modèles payants comme openai/gpt-6-astra nécessitent un solde de portefeuille :
Avec une carte enregistrée, un propriétaire ou un administrateur de l’espace de travail confirme le paiement depuis un lien reçu par e-mail. Sans carte enregistrée, la commande renvoie un lien de paiement qu’un propriétaire ou un administrateur ouvre pour payer, et la carte est enregistrée pour les recharges suivantes.

2. Envoyer une requête textuelle

POST /v1/responses est l’endpoint recommandé pour tout nouveau travail sur du texte. Les exemples utilisent openai/gpt-6-astra, un modèle payant. Pour tester sans crédits, remplacez-le par phaseo/free, qui choisit un modèle gratuit disponible ; voir Lancer avec le routeur gratuit. cURL et fetch ne nécessitent aucune installation. Pour un SDK, installez-le d’abord :
Consultez la page d’installation TypeScript et Python pour la configuration requise et les autres SDK.

3. Lire la réponse

Diffuser la réponse en streaming

Utilisez le streaming pour afficher la réponse au fur et à mesure de sa génération. Le champ text de chaque événement response.output_text.delta ne contient que le nouveau texte : cette boucle affiche donc la réponse une seule fois. Les événements de clôture comme response.output_text.done répètent du texte déjà diffusé. Consultez Streaming pour la liste complète des événements.

4. Dépanner la première requête

La référence des erreurs liste chaque code d’erreur et ce qu’il faut faire.

Obtenir des réponses typées plutôt que du texte

Quand votre code a besoin d’une valeur plutôt que de prose, envoyez vos questions à POST /v1/decisions (Bêta). Chaque réponse revient typée, avec des probabilités, dans le même ordre que les questions. Les types de questions sont predicate (oui/non), choice (l’une de vos options) et score (un niveau sur votre échelle).
La réponse (valeurs indicatives) :
Lisez answers[0].choice ou answers[1].probability, et utilisez confidence ou probabilities pour fixer votre propre seuil. La référence Decisions liste chaque modèle de décision, ses limites et ses prix, l’entrée d’images, ainsi que l’ancien format state avec des tables de questions nommées (noul, criteria), qui fonctionne toujours et que certains modèles exigent.

Générer une vidéo

La génération de vidéo est asynchrone : créez une tâche, interrogez-la, puis téléchargez le fichier.
Pour recevoir un webhook plutôt que d’interroger l’API, consultez Tâches asynchrones et webhooks.

Continuer à développer

Intégrer le Gateway

Choisissez un endpoint et mettez en place une intégration de production.

Référence API

Chaque champ de requête et de réponse, pour chaque endpoint.

Exemples

Des applications de démarrage pour les workflows courants.

Assistance

Obtenez de l’aide pour le débogage, le routage et le comportement des modèles.
Dernière modification le 16 novembre 2026