Passer au contenu principal
Exécutez une CLI Python, limitée à la bibliothèque standard, qui appelle les endpoints Phaseo une commande à la fois. À la fin, python quickstart.py <command> fonctionne pour health, models, Responses et Chat Completions, et vous disposez de commandes pour les embeddings, la modération, les images, l’OCR, la vidéo et la musique, à copier dans un worker ou un backend. La CLI est illustrative : c’est une référence pour la forme des requêtes, pas un outil packagé. Plusieurs de ses ID de modèle par défaut pour les commandes média ne sont plus servis ; passez donc --model pour celles-ci (voir Choisir les modèles des commandes média). Pour qu’un agent de codage crée une CLI similaire de zéro, collez ce prompt :

Créer une CLI de gateway en Python autour des routes Phaseo.

Ouvrir dans Cursor

Ce que fait la CLI

L’exemple est examples/gateway-python-quickstart : un seul fichier, quickstart.py, qui n’utilise que urllib, json et argparse. Chaque requête est réessayée deux fois en cas de 429, de 5xx ou d’erreur réseau, avec une attente de 1 s puis de 2 s, et expire au bout de 45 secondes. Chaque commande se termine avec 1 quand l’appel ne renvoie pas 2xx, ce qui permet de l’utiliser dans des scripts.

Lancer la CLI

Il vous faut Python 3 et une clé API Phaseo.
1

Créer .env.local

Le script lit .env.local depuis le dossier où vous le lancez. L’exemple ne fournit pas de .env.example ; créez donc le fichier :
.env.local
Les variables déjà définies dans votre shell l’emportent sur le fichier. Sans PHASEO_MODEL, les commandes texte utilisent openai/gpt-5.6-sol.
2

Lancer le contrôle rapide

smoke envoie aussi une courte requête Responses ; il consomme donc quelques crédits.
3

Envoyer une requête

Vérifier que tout fonctionne

  • smoke affiche HTTP 200 pour chaque bloc et se termine avec 0.
  • La sortie de la commande responses contient integration_ok.
  • --help liste les commandes sans envoyer de requête.
  • Sans clé, le script affiche Missing PHASEO_API_KEY et se termine avec 1.
  • Les requêtes apparaissent dans Paramètres → Utilisation → Journaux.

Choisir les modèles des commandes média

Ces valeurs par défaut de quickstart.py sont retirées ou n’ont aucun fournisseur actif. Passez un modèle actuel avec --model, choisi sur la page des modèles ou avec python quickstart.py models : Les valeurs par défaut de embeddings (google/gemini-embedding-2) et de image (openai/gpt-image-2) sont servies. Les tâches vidéo et musique sont asynchrones : conservez l’ID renvoyé et interrogez la commande d’état ; Vidéo asynchrone et batch décrit le cycle de vie des tâches. Réduisez le fichier aux commandes dont votre service a besoin, gardez l’unique fonction partagée gateway_request(), et passez au SDK Python quand vous voulez des requêtes typées.
Dernière modification le 5 novembre 2026