Pré-requisitos
Instale e carregue estas skills antes de gerar (pule se já estiverem em contexto via @pruna):
| Skill | Descrição | Instalação |
|---|---|---|
generation-diversity | Use ao escrever qualquer prompt generativo — ritual de seed, estrutura explícita, eixos de cenário e portões de qualidade antes de chamadas pagas de API. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
video-prompting | Use ao criar prompts de vídeo ou movimento para qualquer modelo generativo — dramaturgia, câmera, movimento seguro para física, âncoras de quadro e encadeamento de clipes. | npx skills add PrunaAI/pruna-skills@video-prompting -y |
pruna-api | Use antes de qualquer chamada HTTP Pruna ou Replicate — credenciais, upload/poll/download, lotes paralelos e segurança do agente. | npx skills add PrunaAI/pruna-skills@pruna-api -y |
Ou instale o pacote completo de uma vez: npx skills add PrunaAI/pruna-skills@pruna -y
Siga as seções Antes de gerar / elabore de cada skill — não repita o conteúdo do guia aqui.
Hábito do agente
Na primeira resposta, nomeie `p-video-edit` entre crases, confirme PRUNA_API_KEY (ou pare com links de cadastro do pruna-api), então peça o vídeo de origem (máx. 15s) e o resumo da edição. Abra intake → intake de esclarecimento do generation-diversity antes do primeiro POST. Elabore edições com Elaboração de prompt (dinâmica + fiel) — não cole exemplos da skill. Redirecione quando Quando NÃO usar se encaixar melhor.
Elaboração de prompt (dinâmica + fiel)
prompt é cirúrgico e bloqueado à solicitação. Uma alteração principal por execução. Descreva o estado final desejado, então nomeie o que deve permanecer inalterado. Altere apenas o que o usuário pediu; mantenha câmera, movimento, áudio e elementos não mencionados idênticos.
| Faça | Não faça |
|---|---|
Fórmula: Altere apenas [X]. Preserve [geometria / movimento / câmera / iluminação / sujeitos não mencionados]. | melhore vago / reescritas só de humor que inventam uma nova cena |
| Nomeie cada item que deve permanecer do usuário (sujeito, trajeto da câmera, iluminação, adereços) | Remova cláusulas de keep e espere que o modelo as preserve |
| Ritual de seed antes de elaborar; redação nova para cláusulas de keep quando o resumo permitir | Copie a amostra desta skill (sunset sky) quando o usuário descreveu uma edição diferente |
Aponte para referências quando usadas: adicione o acessório da primeira referência | use a referência vago, sem slot de origem |
Mostre prompt antes do POST quando a redação não estiver bloqueada | Edição silenciosa que altera câmera, elenco ou regiões não solicitadas |
Verificação de fidelidade (antes de pagar): o prompt ainda deve satisfazer a alteração do usuário e cada item declarado que deve permanecer. Não “tempere” extras quando eles pediram um único atributo ou edição de ambiente.
Trabalhos fracos (evite ou avise): uma cena/enredo totalmente novo; adicionar um objeto com seu próprio movimento independente (especialmente uma nova forma na mão); alterar ângulo, movimento ou zoom da câmera.
Limite da skill
| p-video-edit | p-video-replace | |
|---|---|---|
| Pergunta do usuário | Alterar a cor / ambiente / objeto / texto / iluminação neste clipe? | Substituir esta pessoa neste vídeo? |
| Objetivo | Edição por instrução do clipe de origem | Trocar identidade no metraja existente |
| Imagens de referência | Opcionais images — 0 a 4 | Obrigatórias images — 1 a 4 |
| Campo de prompt | prompt | instruction_prompt |
Use p-video-replace quando o trabalho for uma troca de personagem a partir de imagens de referência obrigatórias. Use esta skill para edições guiadas por prompt de atributo, ambiente, objeto, texto ou iluminação.
Quando NÃO usar
Use uma skill diferente:
| Skill | Descrição | Instalação |
|---|---|---|
p-video-2-pro | Use quando alguém quiser um clipe cinematográfico a partir de texto ou quadros inicial/final — anúncios de produto, tomadas documentais ou diálogo com áudio gerado. Não para 1080p, faixas de áudio importadas ou apresentadores apenas com talking-head. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | Use quando alguém quiser um clipe curto polido a partir de texto, imagens ou áudio importado — B-roll 1080p, animação de quadro inicial/final ou uma tomada com movimento com faixa mista. Não para clipes cinematográficos com áudio gerado ou apresentadores apenas com talking-head. | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video | Use quando alguém quiser um clipe curto simples a partir de texto ou imagens — B-roll rápido, rascunhos ou animação de quadro inicial/final. Não quando o resumo precisar de geração cinematográfica, máxima qualidade, sincronia labial precisa ou áudio importado em 1080p. | npx skills add PrunaAI/pruna-skills@p-video -y |
p-video-replace | Use quando alguém quiser trocar uma pessoa, roupa ou produto dentro de um metraje existente mantendo o movimento da câmera e o áudio. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-video-animate | Use quando alguém quiser que uma foto se mova como outro vídeo — transferência de movimento, remixes de dança ou variações de performance a partir de um clipe modelo. | npx skills add PrunaAI/pruna-skills@p-video-animate -y |
video-editing | Use ao montar ou polir clipes já renderizados com ffmpeg — concatenação, crossfades, legendas e subtítulos incorporados, sobreposições de texto/logotipo, controles deslizantes antes/depois, faixas de música de fundo, exportação para plataforma — ou ao compor um vídeo de combinação HTML multicamada com Hyperframes. Não para geração de vídeo por IA, elaboração de prompts ou edições de vídeo baseadas em modelo. | npx skills add PrunaAI/pruna-skills@video-editing -y |
HTTP (curl)
Fazer upload do vídeo de origem
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/caminho/para/video-origem.mp4"
Use o urls.get da resposta em input.video. Duração máxima do vídeo de origem: 15 segundos.
Imagens de referência opcionais
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/caminho/para/imagem-referencia.png"
Use cada urls.get da resposta em input.images (até 4; jpg, jpeg, png, webp).
Criar (assíncrono — recomendado)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/video-origem-abc123",
"prompt": "Altere apenas o céu para um pôr do sol. Preserve o sujeito, o trajeto da câmera e a iluminação no primeiro plano."
}
}'
Consulte e baixe: siga pruna-api. A duração da saída segue o vídeo de origem. O faturamento é por segundo retornado ($0.045 padrão, $0.025 rascunho). Limite de taxa: 50 requisições por minuto.
Complete o ritual de seed aleatório do generation-diversity antes de escrever prompts — não passe a string do ritual como seed da API. seed opcional apenas quando o usuário solicitar reprodutibilidade.
Criar (síncrono — teste rápido apenas)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-H 'Try-Sync: true' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/video-origem-abc123",
"prompt": "Altere apenas o céu para um pôr do sol. Preserve o sujeito, o trajeto da câmera e a iluminação no primeiro plano.",
"draft": true
}
}'
Antes de gerar
- Complete a ordem de leitura dos Pré-requisitos (
generation-diversity→video-prompting). - Ritual de seed → elabore um
promptdinâmico + fiel (seção acima) → confirmevideo(≤15s),prompt,imagesopcionais (0–4),draft,save_audioe a intenção da edição (atributo / remover / adicionar / ambiente / religar / texto / guiado por referência). - Notas da Pruna: uma alteração principal por execução. A correspondência de identidade ou produto vem de
imagesopcionais; a instrução de edição reside emprompt. Alvos vagos e cenas totalmente novas reduzem a qualidade. Não envie um campotask— ele não está na API pública.
Entrada obrigatória
video(string URL): vídeo de origem a ser editado. Duração máxima: 15 segundosprompt(string): instrução de texto descrevendo a edição
Campos opcionais comuns
images(array de até 4 URLs de string): imagem(ns) de referência para edição guiada por referência (jpg,jpeg,png,webp)prompt_upsampling(boolean, padrãotrue)draft(boolean, padrãofalse): visualização mais rápida e de qualidade inferior; faturado a$0.025por segundo de saídasave_audio(boolean, padrãotrue)seed(integer): definido apenas para repetições reproduzíveis
Próximos passos típicos
Acompanhamentos comuns após esta skill:
| Skill | Descrição | Instalação |
|---|---|---|
p-video-replace | Use quando alguém quiser trocar uma pessoa, roupa ou produto dentro de um metraje existente mantendo o movimento da câmera e o áudio. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-image-edit | Use quando alguém quiser editar uma foto existente — trocar roupas ou fundos, compor a partir de imagens de referência ou aplicar edições guiadas por prompt. | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
video-editing | Use ao montar ou polir clipes já renderizados com ffmpeg — concatenação, crossfades, legendas e subtítulos incorporados, sobreposições de texto/logotipo, controles deslizantes antes/depois, faixas de música de fundo, exportação para plataforma — ou ao compor um vídeo de combinação HTML multicamada com Hyperframes. Não para geração de vídeo por IA, elaboração de prompts ou edições de vídeo baseadas em modelo. | npx skills add PrunaAI/pruna-skills@video-editing -y |