Requisitos previos
Instala y carga estas habilidades antes de generar (omite si ya están en contexto mediante @pruna):
| Habilidad | Descripción | Instalación |
|---|---|---|
generation-diversity | Úsala al redactar cualquier prompt generativo: semilla ritual, estructura explícita, ejes de escenario y puertas de calidad antes de llamadas a API de pago. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
image-prompting | Úsala al redactar prompts de imágenes fijas para cualquier modelo generativo: composición, hojas de identidad, ediciones, prueba de vestimenta y personajes fotorrealistas. | npx skills add PrunaAI/pruna-skills@image-prompting -y |
video-prompting | Úsala al redactar prompts de video o movimiento para cualquier modelo generativo: dramaturgia, cámara, movimiento físicamente seguro, anclajes de fotograma y encadenamiento de clips. | npx skills add PrunaAI/pruna-skills@video-prompting -y |
pruna-api | Úsala antes de cualquier llamada HTTP a Pruna o Replicate: credenciales, subida/consulta/descarga, lotes paralelos y seguridad del agente. | npx skills add PrunaAI/pruna-skills@pruna-api -y |
O instala el paquete completo de una vez: npx skills add PrunaAI/pruna-skills@pruna -y
Sigue las secciones Antes de generar / redacta de cada habilidad; no repliques el contenido de la guía aquí.
Hábito del agente
En la primera respuesta, nombra `p-image-edit` entre comillas invertidas, confirma PRUNA_API_KEY y luego pregunta por la foto fuente (y el resumen de la edición). Abre la recepción → utiliza la recepción de aclaración de generation-diversity cuando sea necesario. Redacta las ediciones con Redacción de prompt (dinámica + fiel). Redirige a p-image-try-on cuando el trabajo sea ajuste de prendas a partir de fotos de producto.
Redacción de prompt (dinámica + fiel)
Los prompts de edición son quirúrgicos y apegados a la solicitud. Cambia solo lo que el usuario pidió; mantén todo lo demás idéntico. La diversidad se aplica a cómo redactas el cambio, no a inventar una nueva escena.
| Hacer | No hacer |
|---|---|
Fórmula: Cambia [cosa específica]. Mantén [identidad / pose / iluminación / fondo] idénticos. (redacción de edición de image-prompting) | Mejóralo / reescrituras solo de estado de ánimo que ignoran el resumen |
| Nombra cada elemento a mantener del usuario (rostro, atuendo, pose, fondo, producto) | Omitir cláusulas de conservación y esperar que el modelo las preserve |
Semilla ritual nueva de generation-diversity antes de redactar; varía la redacción libre (materiales, hex, matiz de cámara) cuando el resumen lo permita | Copiar el ejemplo de esta habilidad (degradado suave) cuando el usuario pidió otra cosa |
Señala referencias al componer: rostro de la imagen 1, atuendo de la imagen 2 | Combina estas imágenes vago |
Muestra el prompt de edición antes del POST cuando la redacción no esté bloqueada | Edición silenciosa que cambie el sujeto, especie, edad o regiones no solicitadas |
Verificación de fidelidad (antes de pagar): el prompt debe seguir satisfaciendo el cambio del usuario y cada elemento a conservar declarado. Si falta algún elemento, agrégalo. No "adornes" el fondo/reparto cuando pidieron un intercambio solo de fondo.
Cuándo NO usar
Usa una habilidad diferente en su lugar:
| Habilidad | Descripción | Instalación |
|---|---|---|
p-image | Úsala cuando alguien quiera explícitamente la generación de fotos más rápida y barata: mood boards, paneles masivos o iteraciones rápidas; no cuando se necesite fotorrealismo controlado o texto dentro de la imagen. | npx skills add PrunaAI/pruna-skills@p-image -y |
p-image-try-on | Úsala cuando alguien quiera una prueba virtual de vestimenta: vestir a una persona con ropa de fotos de referencia para moda o comercio electrónico. | npx skills add PrunaAI/pruna-skills@p-image-try-on -y |
p-image-upscale | Úsala cuando alguien quiera escalar o nitificar una imagen existente para impresión, recortes grandes o entrega de mayor calidad. | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
HTTP (curl)
Subir referencias
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/ruta/a/referencia.png"
Usa el urls.get de cada respuesta en input.images.
Crear (así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": "Cambia el fondo a un degradado suave, mantén el sujeto idéntico",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
Consulta y descarga: sigue pruna-api.
Completa el ritual de semilla aleatoria de generation-diversity antes de escribir prompts — no pases la cadena del ritual como seed de la API. seed opcional solo cuando el usuario solicite reproducibilidad.
Crear (síncrono — solo para pruebas rápidas)
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": "Cambia el fondo a un degradado suave, mantén el sujeto idéntico",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
Flujo de edición
Sigue el flujo de prompt de imagen fija de generation-diversity (sección de edición):
- Fijar cambio + elementos a mantener — la solicitud quirúrgica del usuario; fórmula en Redacción de prompt (dinámica + fiel).
- Subir referencias —
POST /v1/files;urls.get→input.images(1–5). Nunca inventes URLs de archivos. - Semilla ritual → redactar prompt de edición (redacción de edición de
image-prompting) → verificación de fidelidad (toda cláusula de conservación presente). - Confirmar —
prompt, referencias,aspect_ratio,turbo(desactivado para ediciones difíciles). - POST — curl asíncrono abajo; lista de verificación antes de escalar/video.
Relación de aspecto: prefiere match_input_image para ediciones; la salida debe mantener la relación de aspecto de la placa — si hay desviación, reintenta con la misma URL de referencia y cláusulas de conservación explícitas.
Nota de Pruna: pipelines de avatar — edita a partir de la URL de héroe escalada bloqueada; escala de nuevo antes de p-video* — nunca pases URLs de edición en bruto a modelos de video.
No es edición: nuevo sujeto desde cero → p-image. Ajuste de prendas a partir de fotos de producto → p-image-try-on.
Múltiples referencias (hasta 5): indexa las referencias por rol — p. ej., composición de tres referencias: rostro de la imagen 1, atuendo de la imagen 2, café de la imagen 3; turbo: false para composiciones difíciles. Patrón completo en image-prompting p-image-edit-prompting.
Entrada requerida
prompt(cadena)images(arreglo de 1–5 URLs, típicamentehttps://api.pruna.ai/v1/files/{id})
Campos opcionales comunes
aspect_ratio:match_input_image,1:1,16:9,9:16, etc.turbo(booleano, por defecto verdadero; desactivar para ediciones más difíciles)seed,disable_safety_checker
Pasos siguientes típicos
Pasos comunes posteriores a esta habilidad:
| Habilidad | Descripción | Instalación |
|---|---|---|
p-image-upscale | Úsala cuando alguien quiera escalar o nitificar una imagen existente para impresión, recortes grandes o entrega de mayor calidad. | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
p-video-2-pro | Úsala cuando alguien quiera un clip cinematográfico a partir de texto o fotogramas de inicio/fin: anuncios de producto, tomas documentales o diálogo con audio generado. No para 1080p, pistas de audio importadas o presentadores solo de talking head. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | Úsala cuando alguien quiera un clip corto pulido a partir de texto, imágenes o audio importado: B-roll en 1080p, animación de fotograma inicio/fin o una toma en movimiento con pista mixta. No para clips cinematográficos con audio generado o presentadores solo de talking head. | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video | Úsala cuando alguien quiera un clip corto simple a partir de texto o imágenes: B-roll rápido, borradores o animación de fotograma inicio/fin. No cuando el resumen necesite generación cinematográfica, máxima calidad, sincronización labial precisa o audio importado a 1080p. | npx skills add PrunaAI/pruna-skills@p-video -y |
p-video-edit | Úsala cuando alguien quiera editar un video existente con una instrucción de texto: recolorear, reestilizar, eliminar o añadir objetos, cambiar el entorno o la iluminación, actualizar texto en pantalla o aplicar ediciones opcionales de productos y accesorios guiadas por referencia. No para un clip nuevo desde cero o ensamblaje con ffmpeg. | npx skills add PrunaAI/pruna-skills@p-video-edit -y |
p-video-avatar | Úsala cuando alguien quiera una persona en cámara hablando un guion: presentador con sincronización labial, portavoz o avatar narrado a partir de una foto de retrato. | npx skills add PrunaAI/pruna-skills@p-video-avatar -y |
avatar-multi-scene | Úsala cuando alguien quiera que la misma persona presente varios clips: UGC de múltiples segmentos, carretes de comparación o escenas mixtas de habla y animación con continuidad. | npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y |
narrated-multi-scene | Úsala cuando alguien quiera una historia en múltiples partes con narración: B-roll episódico, promoción por capítulos o varias escenas de video enlazadas sin diálogo en cámara. | npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y |
visual-transition-reel | Úsala cuando alguien quiera un montaje con transiciones entre tomas: carrete de secuencia de acción o pieza de múltiples escenas donde la narración es opcional. | npx skills add PrunaAI/pruna-skills@visual-transition-reel -y |