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 — semente ritual, 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 |
image-prompting | Use ao criar prompts de imagem estática para qualquer modelo generativo — composição, fichas de identidade, edições, provador virtual e personas fotorrealistas. | npx skills add PrunaAI/pruna-skills@image-prompting -y |
video-prompting | Use ao criar prompts de vídeo ou movimento para qualquer modelo generativo — dramaturgia, câmera, movimento fisicamente seguro, â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 / craft de cada skill — não repita o conteúdo do guia aqui.
Hábito do agente
Na primeira resposta, nomeie `p-image-edit` entre crases, confirme PRUNA_API_KEY e então peça a foto de origem (e o resumo da edição). Abra a triagem → triagem de esclarecimento generation-diversity quando necessário. Elabore edições com Craft de prompt (dinâmico + fiel). Redirecione para p-image-try-on quando o trabalho for ajuste de vestuário a partir de fotos de produto.
Craft de prompt (dinâmico + fiel)
Prompts de edição são cirúrgicos e bloqueados pela solicitação. Mude apenas o que o usuário pediu; mantenha todo o resto idêntico. A diversidade se aplica a como você formula a mudança — não para inventar uma nova cena.
| Faça | Não faça |
|---|---|
Fórmula: Mude [coisa específica]. Mantenha [identidade / pose / iluminação / fundo] idênticos. (craft de edição de image-prompting) | Melhore / reescritas só de humor que ignoram o resumo |
| Nomeie cada item obrigatório a manter do usuário (rosto, roupa, pose, fundo, produto) | Deixe de fora cláusulas de manutenção e espere que o modelo as preserve |
Semente ritual nova de generation-diversity antes de rascunhar; varie a redação livre (materiais, hex, nuances de câmera) quando o resumo permitir | Copie a amostra desta skill (soft gradient) quando o usuário pediu outra coisa |
Aponte referências ao compor: rosto da imagem 1, roupa da imagem 2 | Vago combine estas imagens |
Mostre o prompt de edição antes do POST quando a redação não estiver bloqueada | Edição silenciosa que muda sujeito, espécie, idade ou regiões não solicitadas |
Verificação de fidelidade (antes de pagar): o prompt ainda deve satisfazer a mudança solicitada pelo usuário e cada item declarado a manter. Se faltar um item, adicione-o. Não "tempere" o fundo/elenco quando pediram apenas troca de fundo.
Quando NÃO usar
Use uma skill diferente:
| Skill | Descrição | Instalação |
|---|---|---|
p-image | Use quando alguém quiser explicitamente a geração de fotos mais rápida e barata — quadros de humor, painéis em massa ou iterações rápidas — não quando for necessário fotorrealismo controlado ou texto dentro da imagem. | npx skills add PrunaAI/pruna-skills@p-image -y |
p-image-try-on | Use quando alguém quiser provador virtual — vestir uma pessoa com roupas de fotos de referência para moda ou e-commerce. | npx skills add PrunaAI/pruna-skills@p-image-try-on -y |
p-image-upscale | Use quando alguém quiser aumentar a resolução ou nitidez de uma imagem existente para impressão, recortes grandes ou entrega de maior qualidade. | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
HTTP (curl)
Upload de referências
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/caminho/para/referencia.png"
Use o urls.get de cada resposta em input.images.
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-image-edit' \
-d '{
"input": {
"prompt": "Mude o fundo para gradiente suave, mantenha o sujeito idêntico",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
Faça poll e download: siga pruna-api.
Complete o ritual de semente aleatória de 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 — apenas teste rápido)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-image-edit' \
-H 'Try-Sync: true' \
-d '{
"input": {
"prompt": "Mude o fundo para gradiente suave, mantenha o sujeito idêntico",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
Fluxo de edição
Siga o fluxo de prompt de imagem estática de generation-diversity (seção de edição):
- Trave mudança + itens a manter — pedido cirúrgico do usuário; fórmula em Craft de prompt (dinâmico + fiel).
- Upload de referências —
POST /v1/files;urls.get→input.images(1–5). Nunca invente URLs de arquivo. - Semente ritual → rascunhe o prompt de edição (craft de edição de
image-prompting) → verificação de fidelidade (toda cláusula de manutenção presente). - Confirme —
prompt, referências,aspect_ratio,turbo(desligado para edições difíceis). - POST — curl assíncrono abaixo; checklist antes de upscale/vídeo.
Proporção de aspecto: prefira match_input_image para edições; a saída deve manter a proporção da placa — se houver desvio, tente novamente com a mesma URL de referência e cláusulas de manutenção explícitas.
Nota Pruna: pipelines de avatar — edite a partir da URL hero ampliada e bloqueada; amplie novamente antes de p-video* — nunca passe URLs de edição brutas para modelos de vídeo.
Não é edição: novo sujeito do zero → p-image. Ajuste de vestuário a partir de fotos de produto → p-image-try-on.
Múltiplas referências (até 5): indexe as referências por papel — ex. composta de três referências: rosto da imagem 1, roupa da imagem 2, café da imagem 3; turbo: false para composições difíceis. Padrão completo em image-prompting p-image-edit-prompting.
Entrada necessária
prompt(string)images(array de 1 a 5 URLs, tipicamentehttps://api.pruna.ai/v1/files/{id})
Campos opcionais comuns
aspect_ratio:match_input_image,1:1,16:9,9:16, etc.turbo(booleano, padrão true; desligue para edições mais difíceis)seed,disable_safety_checker
Próximos passos típicos
Etapas comuns após esta skill:
| Skill | Descrição | Instalação |
|---|---|---|
p-image-upscale | Use quando alguém quiser aumentar a resolução ou nitidez de uma imagem existente para impressão, recortes grandes ou entrega de maior qualidade. | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
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, trilhas de áudio importadas ou apresentadores apenas com cabeça falante. | 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 trilha mista. Não para clipes cinematográficos com áudio gerado ou apresentadores apenas com cabeça falante. | 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-edit | Use quando alguém quiser editar um vídeo existente com uma instrução textual — recolorir, reestilizar, remover ou adicionar objetos, mudar ambiente ou iluminação, atualizar texto na tela ou aplicar edições opcionais de produto e acessórios guiadas por referência. Não para um novo clipe do zero ou montagem ffmpeg. | npx skills add PrunaAI/pruna-skills@p-video-edit -y |
p-video-avatar | Use quando alguém quiser uma pessoa na câmera falando um roteiro — apresentador com sincronia labial, porta-voz ou avatar narrado a partir de uma foto de retrato. | npx skills add PrunaAI/pruna-skills@p-video-avatar -y |
avatar-multi-scene | Use quando alguém quiser a mesma pessoa apresentando vários clipes — UGC multi-segmento, reels de comparação ou cenas mistas de fala e animação com continuidade. | npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y |
narrated-multi-scene | Use quando alguém quiser uma história em várias partes com narração — B-roll episódico, promoção em capítulos ou várias cenas de vídeo vinculadas sem diálogo em câmera. | npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y |
visual-transition-reel | Use quando alguém quiser uma montagem com transições entre tomadas — reel de sequência de ação ou peça de várias cenas onde a narração é opcional. | npx skills add PrunaAI/pruna-skills@visual-transition-reel -y |