python quickstart.py <command> für Health, Models, Responses und Chat Completions, dazu kommen Befehle für Embeddings, Moderation, Bilder, OCR, Video und Musik, die du in einen Worker oder ein Backend übernehmen kannst.
Die CLI ist ein Beispiel: Sie dient als Referenz für Anfrageformen, nicht als fertiges Werkzeug. Mehrere ihrer Standard-Modell-IDs für die Medienbefehle werden nicht mehr bedient, also übergib für diese --model (siehe Modelle für die Medienbefehle wählen).
Damit ein Coding-Agent eine ähnliche CLI von Grund auf baut, füge diesen Prompt ein:
Baue eine Python-Gateway-CLI rund um Phaseo-Routen.
Was die CLI macht
Das Beispiel ist examples/gateway-python-quickstart: eine einzige Datei,quickstart.py, die nur urllib, json und argparse verwendet.
Jede Anfrage wird bei
429, 5xx und Netzwerkfehlern zweimal wiederholt, mit 1 s und dann 2 s Wartezeit, und bricht nach 45 Sekunden ab. Jeder Befehl endet mit 1, wenn der Aufruf kein 2xx liefert, sodass du ihn in Skripten verwenden kannst.
Ausführen
Du brauchst Python 3 und einen Phaseo-API-Schlüssel.1
.env.local anlegen
Das Skript liest Variablen, die in deiner Shell bereits gesetzt sind, haben Vorrang vor der Datei. Ohne
.env.local aus dem Ordner, in dem du es ausführst. Das Beispiel enthält keine .env.example, also lege die Datei selbst an:.env.local
PHASEO_MODEL verwenden die Textbefehle openai/gpt-5.6-sol.2
Smoke-Check ausführen
smoke sendet außerdem eine kurze Responses-Anfrage und verbraucht deshalb ein paar Credits.3
Eine Anfrage senden
Prüfen, ob es funktioniert hat
smokegibt für jeden BlockHTTP 200aus und endet mit0.- Die Ausgabe des Befehls
responsesenthältintegration_ok. --helplistet die Befehle auf, ohne eine Anfrage zu senden.- Ohne Schlüssel gibt das Skript
Missing PHASEO_API_KEYaus und endet mit1. - Die Anfragen erscheinen unter Einstellungen → Nutzung → Protokolle.
Modelle für die Medienbefehle wählen
Diese Standardwerte inquickstart.py sind eingestellt oder haben keinen aktiven Anbieter. Übergib mit --model ein aktuelles Modell und wähle es auf der Modellseite oder mit python quickstart.py models aus:
Die Standardwerte für
embeddings (google/gemini-embedding-2) und image (openai/gpt-image-2) werden bedient. Video- und Musikjobs laufen asynchron: Speichere die zurückgegebene ID und frage den Status-Befehl ab; Asynchrone Videos und Batches beschreibt den Lebenszyklus der Jobs.
Kürze die Datei auf die Befehle, die dein Dienst braucht, behalte die gemeinsame Hilfsfunktion gateway_request() und wechsle zum Python-SDK, wenn du typisierte Anfragen möchtest.