Video e imágenesdesde la línea de comandos
Un comando pequeño para scripts y agentes de IA. Inicia sesión con un código que confirmas en un navegador, cotiza cada trabajo antes de ejecutarlo, espera el resultado y guarda el archivo. Por debajo llama a la API pública y gasta tu saldo creativo, como el estudio.
La herramienta aún no está publicada. Los comandos de abajo muestran cómo funciona; el comando de instalación aparecerá aquí cuando se publique.
Conectar tu propio agente de IA está abierto a todas las cuentas y no necesita clave. Las claves de la API para desarrolladores, que sirven para automatizar tu propio trabajo con código, requieren aprobación previa.
Inicia sesión una vezy luego un comando por resultado
Cada comando hace todo el trabajo: cotizar, enviar, esperar y guardar. El progreso va a la salida de error, así que un script solo lee el resultado.
- 01 · Inicio de sesión
Un enlace y un código, sin pegar nada
pershot login muestra un enlace y un código corto. Abre el enlace en cualquier navegador, inicia sesión, comprueba que el código coincide y autorízalo. La herramienta recibe entonces un inicio de sesión creado para ella y lo guarda en un archivo que solo tú puedes leer. Funciona igual en un servidor o en un 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 useSolo necesita un correo verificado. El inicio de sesión aparece en Conexiones de IA, donde puedes limitarlo o revocarlo, y gasta tu saldo creativo, como el estudio.
- 02 · Video
Cotizar, enviar, esperar, guardar
pershot video recibe el prompt entre comillas. Pide el precio y lo muestra, envía el trabajo, lo sigue hasta el final y guarda el clip en la carpeta actual. Lo que escribe en la salida estándar es la ruta del archivo.
# 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 100Sin opciones: Seedance 2.0 Fast, 5 segundos, 720p, 16:9, con audio. Opciones: -m fast o mini, -d de 4 a 15 segundos, -r 480p o 720p, -a 16:9, 9:16 o 1:1, -i un primer fotograma, --ref hasta 9 imágenes de referencia, --no-audio. Las imágenes locales se suben primero.
- 03 · Imagen
Lo mismo para imágenes, o una edición
pershot image funciona igual. Dale una imagen con -i y la edita en lugar de crear una nueva.
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.pngSin opciones: Fast, 1K, 1:1. Opciones: -m fast o mini, -s 1K o 2K, -a 16:9, 9:16 o 1:1. Las imágenes pueden ser archivos PNG, JPEG o WebP, o enlaces https.
- 04 · Para agentes
Una referencia que se lee una vez
pershot help --llms muestra la referencia completa en un solo texto escrito para agentes de IA: cada comando y opción, el JSON que devuelve cada uno y qué significa cada código de salida. Añade --json a cualquier comando para obtener un único objeto JSON en la salida estándar.
# 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, los errores también salen en JSON, en la salida de error, y el código de salida indica qué tipo de problema fue.
Pensada parafuncionar sin supervisión
- El precio primero
- Cada trabajo se cotiza antes de enviarse, y el precio se muestra. --dry-run muestra el precio y se detiene ahí.
- Un tope por comando
- --max-credits rechaza todo lo que cueste más, antes de subir o enviar nada.
- Reintentos seguros
- Cada trabajo se envía con una clave de idempotencia. Indica la tuya con --idempotency-key y, si ejecutas el comando otra vez, recibes el mismo trabajo en lugar de un segundo cobro.
- Trabajos largos
- --no-wait muestra el id del trabajo y vuelve al instante. Si la herramienta deja de esperar, el trabajo sigue, y puedes volver a esperarlo más tarde (código de salida 9, más abajo).
- Su propio inicio de sesión
- El inicio de sesión guardado solo se envía al servidor para el que se creó. Para pagar con el saldo de la API para desarrolladores, define PERSHOT_API_KEY con una clave de la API para desarrolladores (con aprobación previa); sustituye al inicio de sesión guardado.
- Salida limpia
- Los resultados van a la salida estándar; el progreso y los problemas, a la salida de error. --quiet omite las líneas de progreso.
Códigos de salidaque no cambian de significado
Los scripts y los agentes pueden decidir según el código de salida. Cada código significa lo mismo en todas las versiones de la herramienta.
| Código | Significado | Qué hacer |
|---|---|---|
0 | Hecho | Lee el resultado en la salida estándar |
1 | Algo inesperado | Lee el mensaje en la salida de error |
2 | La línea de comandos es incorrecta | Corrígela. Todas las opciones están en la ayuda: pershot help |
3 | No has iniciado sesión, o se rechazó el inicio de sesión o la clave | Inicia sesión: pershot login |
4 | No hay créditos suficientes | Recarga y vuelve a ejecutarlo |
5 | La clave no puede hacer esto: un permiso, un modelo o una región | Usa una clave que tenga permiso |
6 | Rechazado: una solicitud no válida, por encima de --max-credits, un precio que cambió o contenido no permitido | Cambia la solicitud |
7 | Ocupado: el límite de solicitudes o el de trabajos simultáneos | Espera y vuelve a intentarlo |
8 | El trabajo falló o se canceló | Lee el motivo. El trabajo indica lo que costó, si costó algo: pershot job <id> |
9 | Dejó de esperar. El trabajo sigue | Vuelve a esperarlo: pershot job <id> --wait |
10 | No se pudo conectar con el servicio, o respondió con un error del servidor | Reintenta más tarde con la misma --idempotency-key |
11 | Esperando a una persona. Las muestras van primero; el resto espera a que alguien las apruebe en la web | Pide que las revise en el enlace que mostró y luego espera el lote: pershot batch wait <id> |
Preguntas sobrela línea de comandos
¿Cuándo puedo instalarla?
Todavía no: la herramienta no está publicada y las generaciones reales aún no están habilitadas. Deja tu correo en la página de un modelo y te escribiremos una sola vez, cuando se habiliten.
¿Tengo que pegar una clave de API?
No. pershot login muestra un enlace y un código; lo autorizas en tu navegador y la herramienta recibe un inicio de sesión propio, que gasta tu saldo creativo. También puedes definir PERSHOT_API_KEY con una clave de la API para desarrolladores (con aprobación previa), que paga con el saldo de la API para desarrolladores.
¿Dónde guarda el inicio de sesión?
Por defecto en ~/.config/pershot/credentials.json, que solo tu usuario puede leer. pershot logout borra ese archivo. El inicio de sesión en sí sigue en Conexiones de IA hasta que lo revoques allí o venza a los 90 días.
¿Cómo aprende un agente de IA a usarla?
Haz que ejecute pershot help --llms una vez. La referencia cubre cada comando, opción, salida y código de salida, así que el agente no tiene que adivinar.
¿La herramienta cuesta más?
No. Con tu sesión, gasta tu saldo creativo a los mismos precios que el estudio.