Vídeo e imagenspela linha de comando
Um comando pequeno para scripts e agentes de IA. Ele entra com um código que você confirma no navegador, cota cada tarefa antes de rodar, espera o resultado e salva o arquivo. Por baixo, chama a API pública e usa o seu saldo criativo, como o estúdio.
A ferramenta ainda não foi publicada. Os comandos abaixo mostram como ela funciona; o comando de instalação vai aparecer aqui quando ela for lançada.
Conectar o seu próprio agente de IA está aberto a todas as contas e não precisa de chave. As chaves da API para desenvolvedores, que servem para automatizar o seu próprio trabalho com código, são liberadas mediante solicitação.
Entre uma vezdepois um comando por resultado
Cada comando faz o trabalho inteiro: cotar, enviar, esperar e salvar. O progresso vai para a saída de erro, então um script lê só o resultado.
- 01 · Entrar
Um link e um código, sem colar nada
pershot login mostra um link e um código curto. Abra o link em qualquer navegador, entre, confira se o código é o mesmo e autorize. A ferramenta recebe então um login criado para ela e o guarda num arquivo que só você pode ler. Funciona igual num servidor ou num 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 useSó precisa de um e-mail verificado. O login aparece em Conexões de IA, onde você pode limitá-lo ou revogá-lo, e usa o seu saldo criativo, como o estúdio.
- 02 · Vídeo
Cotar, enviar, esperar, salvar
pershot video recebe o prompt entre aspas. Pede o preço e o mostra, envia a tarefa, acompanha até o fim e salva o clipe na pasta atual. O que aparece na saída padrão é o caminho do arquivo.
# 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 100Sem opções: Seedance 2.0 Fast, 5 segundos, 720p, 16:9, com áudio. Opções: -m fast ou mini, -d de 4 a 15 segundos, -r 480p ou 720p, -a 16:9, 9:16 ou 1:1, -i um primeiro quadro, --ref até 9 imagens de referência, --no-audio. Imagens locais são enviadas primeiro.
- 03 · Imagem
O mesmo para imagens, ou uma edição
pershot image funciona do mesmo jeito. Passe uma imagem com -i e ela é editada, em vez de uma nova ser criada.
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.pngSem opções: Fast, 1K, 1:1. Opções: -m fast ou mini, -s 1K ou 2K, -a 16:9, 9:16 ou 1:1. As imagens podem ser arquivos PNG, JPEG ou WebP, ou links https.
- 04 · Para agentes
Uma referência, lida uma vez
pershot help --llms mostra a referência completa num único texto escrito para agentes de IA: cada comando e opção, o JSON que cada um devolve e o que cada código de saída significa. Acrescente --json a qualquer comando para ter um único objeto JSON na saída padrão.
# 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 waitingCom --json, os erros também saem em JSON, na saída de erro, e o código de saída diz que tipo de problema foi.
Feita pararodar sem supervisão
- Preço primeiro
- Cada tarefa é cotada antes de ser enviada, e o preço aparece na tela. --dry-run mostra o preço e para por aí.
- Um teto por comando
- --max-credits recusa qualquer coisa que custe mais, antes de enviar ou subir qualquer arquivo.
- Novas tentativas seguras
- Cada tarefa é enviada com uma chave de idempotência. Defina a sua com --idempotency-key e, ao rodar o comando de novo, você recebe a mesma tarefa em vez de uma segunda cobrança.
- Tarefas longas
- --no-wait mostra o id da tarefa e volta na hora. Se a ferramenta parar de esperar, a tarefa continua, e você pode voltar a esperá-la depois (código de saída 9, abaixo).
- Login próprio
- O login salvo só é enviado ao servidor para o qual foi criado. Para cobrar no saldo da API para desenvolvedores, defina PERSHOT_API_KEY com uma chave da API para desenvolvedores (por solicitação); ela substitui o login salvo.
- Saída limpa
- Os resultados vão para a saída padrão; o progresso e os problemas, para a saída de erro. --quiet omite as linhas de progresso.
Códigos de saídaque não mudam de sentido
Scripts e agentes podem decidir pelo código de saída. Cada código significa o mesmo em todas as versões da ferramenta.
| Código | Significado | O que fazer |
|---|---|---|
0 | Pronto | Leia o resultado na saída padrão |
1 | Algo inesperado | Leia a mensagem na saída de erro |
2 | A linha de comando está errada | Corrija. Todas as opções estão na ajuda: pershot help |
3 | Sem login, ou o login ou a chave foi recusado | Entre: pershot login |
4 | Créditos insuficientes | Recarregue e rode de novo |
5 | A chave não pode fazer isso: uma permissão, um modelo ou uma região | Use uma chave que tenha permissão |
6 | Recusado: pedido inválido, acima de --max-credits, um preço que mudou ou conteúdo não permitido | Mude o pedido |
7 | Ocupado: o limite de requisições ou o de tarefas simultâneas | Espere e tente de novo |
8 | A tarefa falhou ou foi cancelada | Leia o motivo. A tarefa mostra quanto custou, se custou algo: pershot job <id> |
9 | Parou de esperar. A tarefa continua | Espere de novo: pershot job <id> --wait |
10 | Não foi possível conectar ao serviço, ou ele respondeu com erro de servidor | Tente mais tarde com a mesma --idempotency-key |
11 | Aguardando uma pessoa. As amostras vêm primeiro; o resto espera até alguém aprová-las na web | Peça a revisão no link mostrado e depois espere o lote: pershot batch wait <id> |
Perguntas sobrea linha de comando
Quando posso instalar?
Ainda não: a ferramenta não foi publicada e as gerações reais ainda não estão disponíveis. Deixe seu e-mail na página de um modelo e avisaremos uma única vez, quando estiverem.
Preciso colar uma chave de API?
Não. pershot login mostra um link e um código; você autoriza no navegador e a ferramenta recebe um login próprio, que usa o seu saldo criativo. Também dá para definir PERSHOT_API_KEY com uma chave da API para desenvolvedores (por solicitação), que cobra do saldo da API para desenvolvedores.
Onde o login fica guardado?
Por padrão em ~/.config/pershot/credentials.json, que só o seu usuário pode ler. pershot logout apaga esse arquivo. O login em si continua em Conexões de IA até você revogá-lo lá ou ele vencer após 90 dias.
Como um agente de IA aprende a usá-la?
Peça que ele rode pershot help --llms uma vez. A referência cobre cada comando, opção, saída e código de saída, então o agente não precisa adivinhar.
A ferramenta custa a mais?
Não. Com o seu login, ele usa o seu saldo criativo pelos mesmos preços do estúdio.