Eine Python-Gateway-CLI erstellen

​

Beispielprojekt

• GitHub: examples/gateway-python-quickstart
• Lokaler Repository-Pfad: examples/gateway-python-quickstart

​

Was diese Anwendung macht

• unterstützt Steuerungsrouten wie:
  • GET /v1/health
  • GET /v1/models
  • GET /v1/providers
• unterstützt Generierungsrouten wie:
  • POST /v1/responses
  • POST /v1/chat/completions
  • POST /v1/embeddings
  • sowie weitere Endpunkte

​

Warum dieses Beispiel hilfreich ist

• eine Python-Referenz ohne Abhängigkeiten von Drittanbietern
• explizite Anfrageinhalte und Antwortverarbeitung
• ein praktisches Muster für Worker, Skripte und interne Tools

​

Voraussetzungen

• Python 3
• einen Phaseo-API-Schlüssel

​

Beispiel ausführen

cd examples/gateway-python-quickstart
cp .env.example .env.local

• PHASEO_API_KEY

python quickstart.py smoke
python quickstart.py responses --prompt "Return exactly: integration_ok"
python quickstart.py --help

​

Ergebnis prüfen

• Der Schnelltest bestätigt, dass die API erreichbar ist.
• Der Responses-Befehl gibt integration_ok aus.
• --help listet die verfügbaren Befehle auf, ohne eine Anfrage zu senden.
• Authentifizierungs- und API-Fehler werden im Terminal verständlich ausgegeben.

​

Was du im Code ansehen solltest

• wie die Umgebungsvariablen geladen werden
• wie die CLI die Befehle verteilt
• wie die verschiedenen Anfrageinhalte erstellt werden
• wie asynchrone Video- und Musikrouten getrennt von einmaligen Textrouten behandelt werden

​

Das Beispiel anpassen

• entferne die Endpunkte, die dein Dienst nicht benötigt
• verwende eine gemeinsame Hilfsfunktion für Anfragen, statt Header überall zu duplizieren
• wechsle später zum Python-SDK, wenn du einen Client mit höherer Abstraktion möchtest

​

Verwandte Anleitungen

• Einstiegsprompts für Mini-Apps
• Strukturiertes JSON mit Python ausgeben
• Beispiele