GPT Image 2.5 API ist da. Jetzt Bilder erstellen und bearbeiten →
PoYoPoYo
PoYo CLInpm-Paket verfügbar

PoYo-Modelle entdecken und ausführen direkt im Terminal.

Durchsuche den aktuellen Modellkatalog und lies Schemas ohne API Key. Authentifiziere dich erst, wenn du Chats streamst, Generierungsjobs startest oder einen Task per task_id fortsetzt.

$npx -y @poyoapi/cli help
Auf npm ansehenGitHubDocs öffnen

PoYo CLI in drei Schritten starten

Führe zuerst die CLI aus und wähle dann mit models und describe ein Modell. Einen API Key brauchst du erst für die Modellausführung oder Kontodaten.

1

CLI starten

Nutze npx ohne globale Installation. Das veröffentlichte Paket benötigt Node.js 20 oder neuer.

node --version
npx -y @poyoapi/cli help
2

Modell auswählen

Dieses Beispiel findet das aktuell verfügbare Modell gpt-image-2 und liest anschließend dessen aktuelles Eingabe-Schema und öffentlichen Preis aus. Für keinen der beiden Befehle ist ein API-Schlüssel erforderlich.

npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1
npx -y @poyoapi/cli describe gpt-image-2
3

Authentifizieren und ausführen

Erstelle einen API Key und führe dann die drei Befehle unten der Reihe nach aus. Prüfe vor dem kostenpflichtigen Lauf den Preis mit describe; fehlgeschlagene Generierungen verbrauchen keine Credits.

API Key erstellen

1. API Key speichern

Erwartet: Die CLI fragt nach dem Key, ohne ihn anzuzeigen, und meldet danach keyring oder config als Speicherort. Ist der System-Schlüsselspeicher nicht verfügbar, nutzt sie deine PoYo-Konfigurationsdatei.

npx -y @poyoapi/cli auth login

2. Konto und Guthaben prüfen

Erwartet: Kontodaten und verfügbares Guthaben. 401 bedeutet, dass der Key fehlt oder ungültig ist.

npx -y @poyoapi/cli account

3. Preis bestätigen und ausführen

Dies ist eine kostenpflichtige Anfrage. Ein erfolgreiches JSON-Ergebnis enthält task_id, Endstatus und Ausgabedateien.

npx -y @poyoapi/cli run gpt-image-2 --prompt "cinematic product photo" --format json

Modell-Schema in CLI-Parameter umwandeln

Vor chat, run oder submit liest die CLI das Schema des gewählten Modells und wandelt seine Felder in modellspezifische Parameter um.

Vor der Ausführung suchen

models listet den öffentlichen Katalog. describe liefert Schema, Protokolle, Ausführungsmodus, Callback- und Abrechnungsdaten.

Beide Befehle funktionieren ohne API Key.

Generierungs-Prompt

Ein Schema-String wird als normaler Kommandozeilenwert übergeben.

Unbekannte Modelloptionen scheitern lokal. Die vollständige JSON-Schema-Prüfung erfolgt weiterhin in der API.

Jetzt zurückkehren, später fortsetzen

submit gibt sofort eine task_id zurück. task get liest den Status, task wait wartet weiter.

Geeignet für lange Video-, Audio- und 3D-Jobs.

CLI-Ausgaben gezielt steuern

Streaming-Chat schreibt Text oder JSONL nach stdout. Nicht streamende Befehle liefern table, JSON, JSONL oder CSV und können die Ausgabe in eine Datei schreiben.

CLI-Anfragen verwenden dieselben Endpoints und dieselbe Abrechnung wie REST API.

Den passenden Befehl für jede Aufgabe wählen

Eigene Befehle übernehmen Modellsuche, Chat, Generierung, Task-Wiederaufnahme und die lokale MCP-Bridge.

~/projects/poyo-demo
# 1. Modell auswählen
$ npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1

# 2. Erzeugte Befehlseingabe
$ npx -y @poyoapi/cli describe gpt-image-2
  prompt          string   required
  size            string   default: "1:1"
  output_format   string   enum: jpeg | png

# 3. Authentifizieren und ausführen
$ npx -y @poyoapi/cli run gpt-image-2 --prompt "cinematic product photo" --size 4:3 --output-format png --format json
{
  "task_id": "task_7f31b2",
  "status": "succeeded",
  "files": ["https://storage.poyo.ai/.../image.png"]
}

Task-Lebenszyklus

Lange Tasks mit task_id fortsetzen

PoYo gibt den bestehenden öffentlichen Task-Status direkt zurück. Wenn die CLI abbricht oder das Zeitlimit erreicht, fragst du denselben Task weiter ab, statt ihn erneut zu senden.

Ein CLI-Timeout storniert den Backend-Task nicht. Nutze dieselbe task_id statt eine kostenpflichtige Anfrage zu wiederholen.

submit für lange Arbeit
$ npx -y @poyoapi/cli submit gpt-image-2 --prompt "cinematic product photo" --format json

task_id task_7f31b2

$ npx -y @poyoapi/cli task wait TASK_ID --timeout 300 --format json

status succeeded

run für begrenztes Warten

run fragt alle zwei Sekunden ab und wartet standardmäßig höchstens 90 Sekunden.

submit für lange Arbeit

Speichere die task_id und nutze task get oder task wait in einem anderen Terminal oder CI-Schritt.

Zwischen CLI, MCP, REST und Skill wählen

Nutze die CLI im Terminal und in CI, MCP für Agent-Toolaufrufe, die REST API in Anwendungen und Skill für wiederholbare Agent-Workflows.

PoYo CLI

Entwickler, Terminal und CI

Menschen oder Skripte brauchen Suche, Ausführung, Wiederaufnahme und Exit-Codes.

CLI installieren

MCP

AI Agents und Coding-Clients

Ein Agent soll Schema, Preise und Tools über eine Verbindung entdecken.

MCP ansehen

REST API

Anwendungen und Services

Das Produkt steuert Orchestrierung, Streaming, Wiederholungen und Traffic selbst.

Docs öffnen

PoYo Skill

Wiederholbare Agent-Workflows

Ein Agent benötigt zusätzlich zu Schnittstellen Arbeitsanweisungen und Sicherheitsregeln.

Skill ansehen

PoYo CLI FAQ

Noch unsicher bei einem Befehl? PoYo-Support kontaktieren→

Das erste PoYo-Modell im Terminal ausführen

Erkunde zuerst den öffentlichen Katalog und erstelle einen API Key, wenn du ein Modell ausführen möchtest.

API Key erstellenAuf npm ansehen