Video und Bilderaus der Kommandozeile

Ein kleiner Befehl für Skripte und KI-Agenten. Er meldet sich mit einem Code an, den du im Browser bestätigst, nennt vor jedem Auftrag den Preis, wartet auf das Ergebnis und speichert die Datei. Im Hintergrund ruft er die öffentliche API auf und nutzt dein Kreativguthaben, wie das Studio.

Noch nicht veröffentlichtBefehlpershotAPIhttps://api.pershot.app/v1

Das Tool ist noch nicht veröffentlicht. Die Befehle unten zeigen, wie es funktioniert; der Installationsbefehl erscheint hier, sobald es erscheint.

Deinen eigenen KI-Agenten zu verbinden steht jedem Konto offen und braucht keinen Schlüssel. Entwickler-API-Schlüssel, um deine eigene Arbeit per Code zu automatisieren, gibt es auf Antrag.

Einmal anmeldendann ein Befehl pro Ergebnis

Jeder Befehl erledigt den ganzen Auftrag: Preis, Einreichen, Warten, Speichern. Der Fortschritt geht auf die Standardfehlerausgabe, sodass ein Skript nur das Ergebnis liest.

01 · Anmelden
Ein Link und ein Code, nichts einzufügen
pershot login gibt einen Link und einen kurzen Code aus. Öffne den Link in einem beliebigen Browser, melde dich an, prüfe, ob der Code übereinstimmt, und erlaube den Zugriff. Das Tool erhält dann eine eigens dafür erstellte Anmeldung und speichert sie in einer Datei, die nur du lesen kannst. Auf einem Server oder in einer Sandbox funktioniert es genauso.
Terminal
```
pershot login
# Prints a link and a short code. Open the link in any browser,
# check that the code matches and allow it. The key is saved for you.

pershot whoami    # which key and server are in use
```
Es braucht nur eine bestätigte E-Mail-Adresse. Die Anmeldung erscheint unter KI-Verbindungen, wo du sie begrenzen oder widerrufen kannst, und sie nutzt dein Kreativguthaben, wie das Studio.
02 · Video
Preisangebot, Einreichen, Warten, Speichern
pershot video nimmt den Prompt in Anführungszeichen. Es fragt den Preis ab und gibt ihn aus, reicht den Auftrag ein, verfolgt ihn bis zum Ende und speichert den Clip im aktuellen Ordner. Auf der Standardausgabe steht der Pfad der Datei.
Terminal
```
# Prints the price, submits, waits, then the path of the saved .mp4
pershot video "A paper boat on a rain puddle" -m mini -d 8 -r 480p -a 9:16

# The price only; nothing is submitted
pershot video "A paper boat on a rain puddle" --dry-run

# Refuse anything over 100 credits
pershot video "A paper boat on a rain puddle" --max-credits 100
```
Ohne Optionen: Seedance 2.0 Fast, 5 Sekunden, 720p, 16:9, mit Audio. Optionen: -m fast oder mini, -d 4 bis 15 Sekunden, -r 480p oder 720p, -a 16:9, 9:16 oder 1:1, -i ein Startbild, --ref bis zu 9 Referenzbilder, --no-audio. Lokale Bilder werden zuerst hochgeladen.
03 · Bild
Dasselbe für Bilder, oder eine Bearbeitung
pershot image funktioniert genauso. Gib ihm mit -i ein Bild, dann bearbeitet es dieses Bild, statt ein neues zu erstellen.
Terminal
```
pershot image "A ceramic cup on a linen cloth, soft morning light" -s 2K

# Edit a picture instead of making a new one
pershot image "Make the background plain white" -i cup.png
```
Ohne Optionen: Fast, 1K, 1:1. Optionen: -m fast oder mini, -s 1K oder 2K, -a 16:9, 9:16 oder 1:1. Bilder können PNG-, JPEG- oder WebP-Dateien oder https-Links sein.
04 · Für Agenten
Eine Referenz, einmal gelesen
pershot help --llms gibt die vollständige Referenz als einen Text für KI-Agenten aus: jeden Befehl und jede Option, das JSON, das jeder zurückgibt, und was jeder Exit-Code bedeutet. Hänge --json an einen beliebigen Befehl an, um ein einzelnes JSON-Objekt auf der Standardausgabe zu erhalten.
Terminal
```
# The whole reference, written for agents: read it once
pershot help --llms

# One JSON object on standard output, no progress lines
pershot video "A paper boat on a rain puddle" --json --quiet
echo $?    # the exit code: 0 done, 4 not enough credits, 9 stopped waiting
```
Mit --json sind auch Fehler JSON, auf der Standardfehlerausgabe, und der Exit-Code zeigt, welche Art von Problem es war.

Gemacht fürunbeaufsichtigte Läufe

Erst der Preis: Jeder Auftrag bekommt ein Preisangebot, bevor er eingereicht wird, und der Preis wird ausgegeben. --dry-run gibt den Preis aus und hört dort auf.
Eine Obergrenze pro Befehl: --max-credits lehnt alles ab, was mehr kostet, bevor etwas hochgeladen oder eingereicht wird.
Sichere Wiederholungen: Jeder Auftrag wird mit einem Idempotenzschlüssel gesendet. Gib mit --idempotency-key einen eigenen an, dann liefert ein erneuter Aufruf des Befehls denselben Auftrag, statt doppelt zu berechnen.
Lange Aufträge: --no-wait gibt die Auftrags-ID aus und kehrt sofort zurück. Wenn das Tool aufhört zu warten, läuft der Auftrag weiter, und du kannst später erneut darauf warten (Exit-Code 9 unten).
Eine eigene Anmeldung: Die gespeicherte Anmeldung wird immer nur an den Server gesendet, für den sie erstellt wurde. Um stattdessen das Entwickler-API-Guthaben zu belasten, setze PERSHOT_API_KEY auf einen Entwickler-API-Schlüssel (auf Antrag); er ersetzt die gespeicherte Anmeldung.
Saubere Ausgabe: Ergebnisse gehen auf die Standardausgabe, Fortschritt und Probleme auf die Standardfehlerausgabe. --quiet lässt die Fortschrittszeilen weg.

Exit-Codesdie ihre Bedeutung behalten

Skripte und Agenten können anhand des Exit-Codes verzweigen. Jeder Code bedeutet in jeder Version des Tools dasselbe.

Code	Bedeutung	Was tun
`0`	Fertig	Lies das Ergebnis auf der Standardausgabe
`1`	Etwas Unerwartetes	Lies die Meldung auf der Standardfehlerausgabe
`2`	Die Befehlszeile ist falsch	Korrigiere sie. Jede Option steht in der Hilfe: `pershot help`
`3`	Nicht angemeldet, oder Anmeldung oder Schlüssel wurde abgelehnt	Melde dich an: `pershot login`
`4`	Nicht genug Credits	Lade auf und führe ihn dann erneut aus
`5`	Der Schlüssel darf das nicht: eine Berechtigung, ein Modell oder eine Region	Verwende einen Schlüssel, der das darf
`6`	Abgelehnt: eine ungültige Anfrage, über --max-credits, ein geänderter Preis oder unzulässige Inhalte	Ändere die Anfrage
`7`	Ausgelastet: das Ratenlimit oder das Parallelitätslimit	Warte und versuch es dann erneut
`8`	Der Auftrag ist fehlgeschlagen oder wurde abgebrochen	Lies den Grund. Der Auftrag zeigt, was er gekostet hat, falls überhaupt etwas: `pershot job <id>`
`9`	Warten beendet. Der Auftrag läuft weiter	Warte erneut darauf: `pershot job <id> --wait`
`10`	Der Dienst war nicht erreichbar oder hat mit einem Serverfehler geantwortet	Versuch es später mit demselben --idempotency-key erneut
`11`	Wartet auf eine Person. Die Proben liefen zuerst; der Rest wartet, bis jemand sie im Web freigibt	Bitte die Person, über den ausgegebenen Link zu prüfen, und warte dann auf den Stapel: `pershot batch wait <id>`

Fragenzur Kommandozeile

Wann kann ich es installieren?

Noch nicht: Das Tool ist nicht veröffentlicht, und echte Generierungen sind noch nicht verfügbar. Hinterlass deine E-Mail-Adresse auf einer Modellseite, dann schreiben wir dir einmal, sobald sie verfügbar sind.

Muss ich einen API-Schlüssel einfügen?

Nein. pershot login zeigt einen Link und einen Code; du erlaubst den Zugriff im Browser, und das Tool erhält eine eigene Anmeldung, die dein Kreativguthaben nutzt. Ein Entwickler-API-Schlüssel (auf Antrag) in PERSHOT_API_KEY funktioniert auch und belastet stattdessen das Entwickler-API-Guthaben.

Wo speichert es seine Anmeldung?

Standardmäßig in ~/.config/pershot/credentials.json, nur für deinen Benutzer lesbar. pershot logout löscht diese Datei. Die Anmeldung selbst bleibt unter KI-Verbindungen bestehen, bis du sie dort widerrufst oder bis sie nach 90 Tagen endet.

Wie lernt ein KI-Agent, es zu benutzen?

Lass ihn einmal pershot help --llms ausführen. Die Referenz deckt jeden Befehl, jede Option, jede Ausgabe und jeden Exit-Code ab, sodass der Agent nicht raten muss.

Kostet das Tool extra?

Nein. Angemeldet nutzt es dein Kreativguthaben zu denselben Preisen wie das Studio.

Ein Link und ein Code, nichts einzufügen

Preisangebot, Einreichen, Warten, Speichern

Dasselbe für Bilder, oder eine Bearbeitung

Eine Referenz, einmal gelesen