Zum Hauptinhalt springen
Führe eine Python-CLI aus, die nur die Standardbibliothek nutzt und Phaseo-Endpunkte Befehl für Befehl aufruft. Am Ende funktioniert 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.

In Cursor öffnen

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 .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
Variablen, die in deiner Shell bereits gesetzt sind, haben Vorrang vor der Datei. Ohne 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

  • smoke gibt für jeden Block HTTP 200 aus und endet mit 0.
  • Die Ausgabe des Befehls responses enthält integration_ok.
  • --help listet die Befehle auf, ohne eine Anfrage zu senden.
  • Ohne Schlüssel gibt das Skript Missing PHASEO_API_KEY aus und endet mit 1.
  • Die Anfragen erscheinen unter Einstellungen → Nutzung → Protokolle.

Modelle für die Medienbefehle wählen

Diese Standardwerte in quickstart.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.
Zuletzt geändert am 5. November 2026