Pré-requisitos
Instale e carregue estas skills antes de gerar (pule se já estiverem no contexto via @pruna):
| Skill | Descrição | Instalação |
|---|---|---|
generation-diversity | Use ao escrever qualquer prompt generativo — seed 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, prova virtual e personas fotorealistas. | npx skills add PrunaAI/pruna-skills@image-prompting -y |
pruna-api | Use antes de qualquer chamada HTTP para 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 conjunto completo de uma vez: npx skills add PrunaAI/pruna-skills@pruna -y
Siga as seções Antes de gerar / de criação de cada skill — não reafirme o conteúdo do guia aqui.
Hábito do agente
Roteamento: Use `p-image` para geração de fotos simples e rápida a partir de um prompt curto. Quando a geração de fotos precisar de mais controle (texto na imagem, JSON estruturado com hex/bbox, fotorealismo de alto detalhe), use `p-image-ideogram` (padrão: thinking: high, prompt_upsampling: true; Use low + prompt_upsampling: false + prompt explícito para uma passagem mais rápida no mesmo modelo). Para edições ou vídeo, use `p-image-edit` ou `p-video-2` — não uma nova geração de foto.
Na primeira resposta, nomeie `p-image` entre crases, confirme se PRUNA_API_KEY está configurada (ou pare com links de cadastro de pruna-api), então pergunte pelo prompt / proporção de aspecto (coleta aberta → coleta de esclarecimento do generation-diversity). Ao redigir o prompt, siga Criação de prompt (dinâmico + fiel) — não cole exemplos da skill.
Criação de prompt (dinâmico + fiel)
Todo input.prompt deve ser novo e específico, e deve manter o pedido do usuário. Diversidade nunca substitui o briefing.
| Faça | Não faça |
|---|---|
Execute o ritual de seed aleatório do generation-diversity; mencione-o; gire ≥2 eixos livres (câmera, iluminação, textura do cenário, categoria de renderização) | Copie exemplos de curl desta skill (otter DJ, corgi cowboy, …) ou reutilize um prompt de sessão anterior |
| Trave primeiro os fatos exigidos pelo usuário (sujeito, produto, pistas de marca, objetos obrigatórios, texto legível se solicitado) | Troque o sujeito por uma cena "mais legal" que ignore o pedido |
Expanda com substantivos concretos, ação congelada, materiais, posicionamento (regras de ouro do image-prompting) | Apenas strings vagas de clima (cool product vibe, neon) |
Mostre o prompt redigido + aspect_ratio antes do POST quando o usuário não tiver travado a redação | Regeneração silenciosa com sujeito diferente do aprovado |
Verificação de fidelidade (antes de pagar): se você remover o sujeito/produto/cenário nomeado pelo usuário do prompt, o trabalho está errado — reescreva. Eixos livres apenas preenchem o que o briefing deixou em aberto.
Ao mostrar um prompt redigido, ainda nomeie `p-image` (os guias ajudam na criação; esta ferramenta é dona da chamada).
Nota Pruna: p-image não tem upsampling de prompt — linguagem concreta é toda a criação. Evite tipografia densa legível a menos que o usuário tenha explicitamente pedido texto em uma superfície.
Quando NÃO usar
Use uma skill diferente:
| Skill | Descrição | Instalação |
|---|---|---|
p-image-ideogram | Use quando a geração de fotos precisar de mais controle — resultados fotorealistas, texto na imagem ou JSON estruturado com cores hex e bounding boxes. Geração de fotos mais simples, edições e vídeo usam outras skills do conjunto. | npx skills add PrunaAI/pruna-skills@p-image-ideogram -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 |
p-image-try-on | Use quando alguém quiser prova 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 |
HTTP (curl)
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' \
-d '{
"input": {
"prompt": "Disco ball reflections on an otter DJ scratching vinyl at a packed 1970s roller rink, fish-eye lens, glitter confetti mid-air, funky energy",
"aspect_ratio": "9:16"
}
}'
Faça poll e download: siga pruna-api.
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. 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' \
-H 'Try-Sync: true' \
-d '{"input":{"prompt":"Corgi cowboy lassoing a runaway taco truck through Monument Valley dust storm, pulp western poster energy, dynamic diagonal composition","aspect_ratio":"16:9"}}'
Fluxo de geração
Siga o fluxo de prompt de imagem estática do generation-diversity a cada vez:
- Travar briefing — sujeito, produto, formato, qualquer texto em superfície do usuário.
- Seed ritual — string nova; derive eixos livres (câmera, iluminação,
render_category_tag,aspect_ratioquando não definido). - Redigir prompt explícito — Criação de prompt (dinâmico + fiel) + regras de ouro do
image-prompting; verificação de fidelidade antes de pagar. - Confirmar — mostrar
prompt+aspect_ratioa menos que a redação esteja travada. - POST — curl assíncrono abaixo; faça poll via
pruna-api; execute a lista de verificação de qualidade dop-imageantes de upscale/vídeo.
Proporção de aspecto: passe aspect_ratio em input; se as dimensões de saída não corresponderem (ex: pediu 16:9, veio retrato), tente novamente uma vez com redação explícita horizontal wide / vertical no prompt.
Mood board / lote: novo ritual por imagem independente; aspect_ratio diferente por painel quando o formato não estiver travado.
Foto aprovada → editar: passe para p-image-edit na URL de saída — não execute geração de foto novamente para o mesmo sujeito.
Entrada necessária
prompt(string)
Campos opcionais comuns
aspect_ratio:1:1,16:9,9:16,4:3,3:4,3:2,2:3,custom(comwidth/heightmúltiplos de 16, 256–1440)seed,lora_weights,lora_scale,hf_api_token,disable_safety_checker
Próximos passos típicos
Continuações comuns após esta skill:
| Skill | Descrição | Instalação |
|---|---|---|
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 |
p-image-try-on | Use quando alguém quiser prova 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 |
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 briefing exigir geração cinematográfica, qualidade mais alta, sincronia labial precisa ou áudio importado em 1080p. | npx skills add PrunaAI/pruna-skills@p-video -y |
avatar-single-scene | Use quando alguém quiser uma tomada polida de apresentador na câmera — uma pessoa falando com portões de coleta e aprovação antes da geração. | npx skills add PrunaAI/pruna-skills@avatar-single-scene -y |
avatar-multi-scene | Use quando alguém quiser a mesma pessoa apresentando vários clipes — UGC de múltiplos segmentos, reels de comparação ou cenas mistas de fala e animação com continuidade. | npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y |