Vidéo et imagesen ligne de commande
Une petite commande pour les scripts et les agents IA. Elle se connecte avec un code que vous confirmez dans un navigateur, chiffre chaque tâche avant son lancement, attend le résultat et enregistre le fichier. En coulisse, elle appelle l’API publique, et elle dépense votre solde création, comme le studio.
L’outil n’est pas encore publié. Les commandes ci-dessous montrent son fonctionnement ; la commande d’installation figurera ici à sa sortie.
Connecter votre propre agent IA est ouvert à tous les comptes, sans clé. Les clés API développeur, pour automatiser votre propre travail par le code, sont délivrées sur demande.
Connectez-vous une foispuis une commande par résultat
Chaque commande fait tout le travail : prix, envoi, attente, enregistrement. L’avancement va sur la sortie d’erreur standard : un script ne lit donc que le résultat.
- 01 · Connexion
Un lien et un code, rien à coller
pershot login affiche un lien et un code court. Ouvrez le lien dans n’importe quel navigateur, connectez-vous, vérifiez que le code correspond et autorisez-le. L’outil reçoit alors une connexion créée pour lui et la garde dans un fichier que vous seul pouvez lire. Cela fonctionne de la même façon sur un serveur ou dans un bac à sable.
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 useIl suffit d’une adresse e-mail vérifiée. La connexion apparaît sous Connexions IA, où vous pouvez la plafonner ou la révoquer, et elle dépense votre solde création, comme le studio.
- 02 · Vidéo
Devis, envoi, attente, enregistrement
pershot video prend le prompt entre guillemets. Elle demande le prix et l’affiche, envoie la tâche, la suit jusqu’au bout et enregistre le clip dans le dossier courant. Ce qu’elle affiche sur la sortie standard est le chemin du fichier.
# 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 100Sans options : Seedance 2.0 Fast, 5 secondes, 720p, 16:9, avec audio. Options : -m fast ou mini, -d 4 à 15 secondes, -r 480p ou 720p, -a 16:9, 9:16 ou 1:1, -i une première image, --ref jusqu’à 9 images de référence, --no-audio. Les images locales sont importées d’abord.
- 03 · Image
Pareil pour les images, ou une retouche
pershot image fonctionne de la même façon. Donnez-lui une image avec -i et elle retouche cette image au lieu d’en créer une nouvelle.
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.pngSans options : Fast, 1K, 1:1. Options : -m fast ou mini, -s 1K ou 2K, -a 16:9, 9:16 ou 1:1. Les images peuvent être des fichiers PNG, JPEG ou WebP, ou des liens https.
- 04 · Pour les agents
Une référence, lue une fois
pershot help --llms affiche la référence complète en un seul texte écrit pour les agents IA : chaque commande et option, le JSON que chacune renvoie et la signification de chaque code de sortie. Ajoutez --json à n’importe quelle commande pour obtenir un seul objet JSON sur la sortie standard.
# 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 waitingAvec --json, les erreurs sont aussi en JSON, sur la sortie d’erreur standard, et le code de sortie indique le type de problème.
Conçu pourtourner sans surveillance
- Le prix d’abord
- Chaque tâche fait l’objet d’un devis avant son envoi, et le prix est affiché. --dry-run affiche le prix et s’arrête là.
- Un plafond par commande
- --max-credits refuse tout ce qui coûte plus, avant tout import ou envoi.
- Des nouvelles tentatives sans risque
- Chaque tâche est envoyée avec une clé d’idempotence. Fournissez la vôtre avec --idempotency-key : relancer la commande renvoie alors la même tâche au lieu de facturer deux fois.
- Tâches longues
- --no-wait affiche l’identifiant de la tâche et rend la main aussitôt. Si l’outil cesse d’attendre, la tâche continue, et vous pouvez l’attendre à nouveau plus tard (code de sortie 9 ci-dessous).
- Sa propre connexion
- La connexion enregistrée n’est jamais envoyée qu’au serveur pour lequel elle a été créée. Pour facturer plutôt le solde de l’API développeur, définissez PERSHOT_API_KEY avec une clé API développeur (sur demande) ; elle remplace la connexion enregistrée.
- Une sortie propre
- Les résultats vont sur la sortie standard ; l’avancement et les problèmes sur la sortie d’erreur standard. --quiet supprime les lignes d’avancement.
Des codes de sortiequi gardent leur sens
Les scripts et les agents peuvent se baser sur le code de sortie. Chaque code a la même signification dans toutes les versions de l’outil.
| Code | Signification | Que faire |
|---|---|---|
0 | Terminé | Lisez le résultat sur la sortie standard |
1 | Un problème inattendu | Lisez le message sur la sortie d’erreur standard |
2 | La ligne de commande est incorrecte | Corrigez-la. Toutes les options sont dans l’aide : pershot help |
3 | Pas connecté, ou la connexion ou la clé a été refusée | Connectez-vous : pershot login |
4 | Pas assez de crédits | Rechargez, puis relancez |
5 | La clé n’a pas le droit de faire cela : une permission, un modèle ou une région | Utilisez une clé qui en a le droit |
6 | Refusé : une requête invalide, au-delà de --max-credits, un prix qui a changé, ou un contenu non autorisé | Modifiez la requête |
7 | Occupé : la limite de débit ou de simultanéité | Attendez, puis réessayez |
8 | La tâche a échoué ou a été annulée | Lisez pourquoi. La tâche indique ce qu’elle a coûté, le cas échéant : pershot job <id> |
9 | Attente interrompue. La tâche continue | Attendez-la à nouveau : pershot job <id> --wait |
10 | Le service n’a pas pu être joint, ou a répondu par une erreur serveur | Réessayez plus tard avec le même --idempotency-key |
11 | En attente d’une personne. Les échantillons ont été lancés d’abord ; le reste attend que quelqu’un le valide sur le web | Demandez-lui de vérifier au lien affiché, puis attendez le lot : pershot batch wait <id> |
Questionssur la ligne de commande
Quand pourrai-je l’installer ?
Pas encore : l’outil n’est pas publié, et les vraies générations ne sont pas encore ouvertes. Laissez votre e-mail sur la page d’un modèle et nous vous écrirons une seule fois, à leur ouverture.
Dois-je y coller une clé API ?
Non. pershot login affiche un lien et un code ; vous l’autorisez dans votre navigateur et l’outil reçoit sa propre connexion, qui dépense votre solde création. Une clé API développeur (sur demande) dans PERSHOT_API_KEY fonctionne aussi et facture plutôt le solde de l’API développeur.
Où garde-t-il sa connexion ?
Dans ~/.config/pershot/credentials.json par défaut, lisible uniquement par votre utilisateur. pershot logout supprime ce fichier. La connexion elle-même reste sous Connexions IA jusqu’à ce que vous la révoquiez, ou jusqu’à son expiration au bout de 90 jours.
Comment un agent IA apprend-il à l’utiliser ?
Faites-lui lancer une fois pershot help --llms. La référence couvre chaque commande, option, sortie et code de sortie : l’agent n’a donc rien à deviner.
L’outil coûte-t-il plus cher ?
Non. Une fois connecté, il dépense votre solde création aux mêmes prix que le studio.