Video e immaginidalla riga di comando
Un piccolo comando per script e agenti IA. Accede con un codice che confermi nel browser, fa il preventivo di ogni lavoro prima di eseguirlo, attende il risultato e salva il file. Dietro le quinte chiama l'API pubblica, e spende il tuo saldo creativo, come lo studio.
Lo strumento non è ancora pubblicato. I comandi qui sotto mostrano come funziona; il comando di installazione comparirà qui al momento del rilascio.
Collegare il tuo agente IA è aperto a tutti gli account e non serve una chiave. Le chiavi API sviluppatori, per automatizzare il tuo lavoro dal codice, sono su richiesta.
Accedi una voltapoi un comando per ogni risultato
Ogni comando fa tutto il lavoro: prezzo, invio, attesa, salvataggio. L'avanzamento va sullo standard error, così uno script legge solo il risultato.
- 01 · Accesso
Un link e un codice, niente da incollare
pershot login stampa un link e un codice breve. Apri il link in qualsiasi browser, accedi, controlla che il codice corrisponda e autorizzalo. Lo strumento riceve quindi un accesso creato apposta e lo conserva in un file che puoi leggere solo tu. Funziona allo stesso modo su un server o in una sandbox.
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 useServe solo un'email verificata. L'accesso compare in Connessioni IA, dove puoi limitarlo o revocarlo, e spende il tuo saldo creativo, come lo studio.
- 02 · Video
Preventivo, invio, attesa, salvataggio
pershot video accetta il prompt tra virgolette. Chiede il prezzo e lo stampa, invia il lavoro, lo segue fino alla fine e salva la clip nella cartella corrente. Ciò che stampa sullo standard output è il percorso del file.
# 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 100Senza opzioni: Seedance 2.0 Fast, 5 secondi, 720p, 16:9, con audio. Opzioni: -m fast o mini, -d da 4 a 15 secondi, -r 480p o 720p, -a 16:9, 9:16 o 1:1, -i un primo fotogramma, --ref fino a 9 immagini di riferimento, --no-audio. Le immagini locali vengono caricate prima.
- 03 · Immagine
Lo stesso per le immagini, o una modifica
pershot image funziona allo stesso modo. Passagli un'immagine con -i e modifica quell'immagine invece di crearne una nuova.
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.pngSenza opzioni: Fast, 1K, 1:1. Opzioni: -m fast o mini, -s 1K o 2K, -a 16:9, 9:16 o 1:1. Le immagini possono essere file PNG, JPEG o WebP, oppure link https.
- 04 · Per gli agenti
Un unico riferimento, da leggere una volta
pershot help --llms stampa il riferimento completo come un unico testo scritto per gli agenti IA: ogni comando e opzione, il JSON che ciascuno restituisce e cosa significa ogni codice di uscita. Aggiungi --json a qualsiasi comando per avere un solo oggetto JSON sullo standard output.
# 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 waitingCon --json anche gli errori sono in JSON, sullo standard error, e il codice di uscita dice che tipo di problema c'è stato.
Pensato peresecuzioni senza supervisione
- Prima il prezzo
- Ogni lavoro riceve un preventivo prima dell'invio, e il prezzo viene stampato. --dry-run stampa il prezzo e si ferma lì.
- Un tetto per comando
- --max-credits rifiuta tutto ciò che costa di più, prima di caricare o inviare qualsiasi cosa.
- Nuovi tentativi sicuri
- Ogni lavoro viene inviato con una chiave di idempotenza. Passane una tua con --idempotency-key, e rieseguire il comando restituisce lo stesso lavoro invece di addebitarlo due volte.
- Lavori lunghi
- --no-wait stampa l'id del lavoro e termina subito. Se lo strumento smette di attendere, il lavoro continua, e puoi attenderlo di nuovo più tardi (codice di uscita 9 qui sotto).
- Un accesso tutto suo
- L'accesso salvato viene inviato solo al server per cui è stato creato. Per addebitare invece il saldo API sviluppatori, imposta PERSHOT_API_KEY con una chiave API sviluppatori (su richiesta); prende il posto dell'accesso salvato.
- Uscita pulita
- I risultati vanno sullo standard output; avanzamento e problemi sullo standard error. --quiet omette le righe di avanzamento.
Codici di uscitache non cambiano significato
Script e agenti possono decidere in base al codice di uscita. Ogni codice significa la stessa cosa in tutte le versioni dello strumento.
| Codice | Significato | Cosa fare |
|---|---|---|
0 | Fatto | Leggi il risultato sullo standard output |
1 | Qualcosa di imprevisto | Leggi il messaggio sullo standard error |
2 | La riga di comando è sbagliata | Correggila. Tutte le opzioni sono nella guida: pershot help |
3 | Accesso non effettuato, oppure l'accesso o la chiave sono stati rifiutati | Accedi: pershot login |
4 | Crediti insufficienti | Ricarica, poi eseguilo di nuovo |
5 | La chiave non può farlo: un permesso, un modello o un'area geografica | Usa una chiave autorizzata a farlo |
6 | Rifiutato: una richiesta non valida, oltre --max-credits, un prezzo cambiato o un contenuto non consentito | Modifica la richiesta |
7 | Occupato: il limite di richieste o il limite di concorrenza | Attendi, poi riprova |
8 | Il lavoro non è riuscito o è stato annullato | Leggi il motivo. Il lavoro mostra quanto è costato, se è costato qualcosa: pershot job <id> |
9 | Attesa interrotta. Il lavoro continua | Attendilo di nuovo: pershot job <id> --wait |
10 | Il servizio non era raggiungibile, o ha risposto con un errore del server | Riprova più tardi con la stessa --idempotency-key |
11 | In attesa di una persona. Prima sono stati eseguiti i campioni; il resto attende che qualcuno li approvi sul web | Chiedi di controllarli al link stampato, poi attendi il lotto: pershot batch wait <id> |
Domandesulla riga di comando
Quando posso installarlo?
Non ancora: lo strumento non è pubblicato, e le generazioni reali non sono ancora aperte. Lascia la tua email nella pagina di un modello e ti scriveremo una volta sola, quando apriranno.
Devo incollarci una chiave API?
No. pershot login mostra un link e un codice; lo autorizzi nel browser e lo strumento riceve un accesso tutto suo, che spende il tuo saldo creativo. Funziona anche una chiave API sviluppatori (su richiesta) in PERSHOT_API_KEY, che invece addebita il saldo API sviluppatori.
Dove conserva il suo accesso?
In ~/.config/pershot/credentials.json per impostazione predefinita, leggibile solo dal tuo utente. pershot logout elimina quel file. L'accesso in sé resta in Connessioni IA finché non lo revochi lì, o finché non scade dopo 90 giorni.
Come impara a usarlo un agente IA?
Fagli eseguire pershot help --llms una volta. Il riferimento copre ogni comando, opzione, risultato e codice di uscita, così l'agente non deve tirare a indovinare.
Lo strumento costa di più?
No. Con l'accesso, spende il tuo saldo creativo agli stessi prezzi dello studio.