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 escribir cualquier prompt generativo: semilla ritual, estructura explícita, ejes de escenario y compuertas de calidad antes de llamadas a API de pago. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
video-prompting | Úsala al crear prompts de video o movimiento para cualquier modelo generativo: dramaturgia, cámara, movimiento físicamente seguro, anclas 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 una vez: npx skills add PrunaAI/pruna-skills@pruna -y
Sigue las secciones Antes de generar / elaboración de cada habilidad; no repitas el contenido de la guía aquí.
Hábito del agente
En la primera respuesta, nombra `p-video-edit` entre comillas invertidas, confirma PRUNA_API_KEY (o detente con enlaces de registro de pruna-api), luego pregunta por el video fuente (máx. 15 s) y el resumen de la edición. Apertura de ingesta → ingesta de clarificación de generation-diversity antes del primer POST. Redacta las ediciones con Elaboración de prompt (dinámico + fiel) — no pegues ejemplos de la habilidad. Redirige cuando Cuándo NO usarlo sea más adecuado.
Elaboración de prompt (dinámico + fiel)
El prompt es quirúrgico y bloqueado por solicitud. Un cambio principal por ejecución. Describe el estado final deseado, luego nombra lo que debe permanecer igual. Cambia solo lo que el usuario pidió; mantén idénticos la cámara, el movimiento, el audio y los elementos no mencionados.
| Sí | No |
|---|---|
Fórmula: Cambia solo [X]. Conserva [geometría / movimiento / cámara / iluminación / sujetos no mencionados]. | Cambios vagos como mejóralo / reescrituras solo de ambiente que inventan una nueva escena |
| Nombra todo lo que debe conservarse del usuario (sujeto, trayectoria de cámara, iluminación, accesorios) | Omite las cláusulas de conservación y esperas que el modelo las preserve |
| Semilla ritual antes de redactar; redacción fresca para las cláusulas de conservación cuando el resumen lo permita | Copias los ejemplos de esta habilidad (cielo al atardecer) cuando el usuario describió una edición diferente |
Señala las referencias cuando se usen: agrega el accesorio de la primera referencia | Vago usa la referencia sin indicar la fuente |
Muestra el prompt antes del POST cuando la redacción no esté bloqueada | Edición silenciosa que cambia la cámara, el elenco o regiones no solicitadas |
Verificación de fidelidad (antes de pagar): el prompt debe seguir satisfaciendo el cambio del usuario y todas las cláusulas de conservación indicadas. No “aderezos” extras cuando pidieron un solo atributo o edición de entorno.
Trabajos débiles (evitar o advertir): una escena/trama completamente nueva; agregar un objeto con su propio movimiento independiente (especialmente una forma nueva en la mano); cambiar el ángulo de cámara, el movimiento de cámara o el zoom.
Límite de la habilidad
| p-video-edit | p-video-replace | |
|---|---|---|
| Pregunta del usuario | ¿Cambiar el color / entorno / objeto / texto / iluminación en este clip? | ¿Reemplazar a esta persona en este video? |
| Objetivo | Edición por instrucción del clip fuente | Intercambiar identidad en el metraje existente |
| Imágenes de referencia | Opcional images — 0 a 4 | Obligatorio images — 1 a 4 |
| Campo de prompt | prompt | instruction_prompt |
Usa p-video-replace cuando el trabajo sea un intercambio de personaje a partir de imágenes fijas de referencia obligatorias. Usa esta habilidad para ediciones de atributos, entorno, objetos, texto o iluminación guiadas por prompt.
Cuándo NO usarlo
Usa una habilidad diferente en su lugar:
| Habilidad | Descripción | Instalación |
|---|---|---|
p-video-2-pro | Úsala cuando alguien quiera un clip cinematográfico a partir de texto o fotogramas de inicio/fin — anuncios de productos, tomas documentales o diálogos con audio generado. No para 1080p, pistas de audio importadas o solo presentadores hablando. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | Úsala cuando alguien quiera un clip corto y pulido a partir de texto, imágenes o audio importado — metraje 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 solo presentadores hablando. | 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 en 1080p. | npx skills add PrunaAI/pruna-skills@p-video -y |
p-video-replace | Úsala cuando alguien quiera intercambiar una persona, vestimenta o producto dentro de un metraje existente manteniendo el movimiento de cámara y el audio. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-video-animate | Úsala cuando alguien quiera que una foto se mueva como otro video — transferencia de movimiento, remezclas de baile o variaciones de rendimiento a partir de un clip plantilla. | npx skills add PrunaAI/pruna-skills@p-video-animate -y |
video-editing | Úsala para ensamblar o pulir clips ya renderizados con ffmpeg — concatenar, fundidos cruzados, subtítulos y leyendas quemados, superposiciones de texto/logotipo, controles deslizantes antes/después, pistas musicales de fondo, exportación para plataformas — o para componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, elaboración de prompts ni ediciones de video basadas en modelos. | npx skills add PrunaAI/pruna-skills@video-editing -y |
HTTP (curl)
Subir video fuente
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/ruta/al/video-fuente.mp4"
Usa la respuesta urls.get en input.video. Duración máxima del video fuente: 15 segundos.
Imágenes de referencia opcionales
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/ruta/a/imagen-referencia.png"
Usa cada respuesta urls.get en input.images (hasta 4; jpg, jpeg, png, webp).
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-video-edit' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/source-video-abc123",
"prompt": "Cambia solo el cielo a un atardecer. Conserva el sujeto, la trayectoria de la cámara y la iluminación del primer plano."
}
}'
Consulta y descarga: sigue pruna-api. La duración de salida sigue la del video fuente. La facturación es por segundo devuelto ($0.045 estándar, $0.025 borrador). Límite de velocidad: 50 solicitudes por minuto.
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 prueba rápida)
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/source-video-abc123",
"prompt": "Cambia solo el cielo a un atardecer. Conserva el sujeto, la trayectoria de la cámara y la iluminación del primer plano.",
"draft": true
}
}'
Antes de generar
- Completa el orden de lectura de los Requisitos previos (
generation-diversity→video-prompting). - Semilla ritual → redacta un
promptdinámico + fiel (sección anterior) → confirmavideo(≤15 s),prompt,imagesopcional (0–4),draft,save_audioe intención de edición (atributo / eliminar / agregar / entorno / reiluminar / texto / guiado por referencia). - Notas de Pruna: un cambio principal por ejecución. La coincidencia de identidad o producto proviene de
imagesopcional; la instrucción de edición va enprompt. Los objetivos vagos y las escenas completamente nuevas reducen la calidad. No envíes un campotask— no está en la API pública.
Entrada requerida
video(string URL): video fuente a editar. Duración máxima: 15 segundosprompt(string): instrucción de texto que describe la edición
Campos opcionales comunes
images(array de hasta 4 URLs de string): imagen(es) de referencia para edición guiada por referencia (jpg,jpeg,png,webp)prompt_upsampling(booleano, por defectotrue)draft(booleano, por defectofalse): vista previa más rápida y de menor calidad; facturado a$0.025por segundo de salidasave_audio(booleano, por defectotrue)seed(entero): establecer solo para ejecuciones reproducibles
Pasos siguientes típicos
Seguimientos comunes después de esta habilidad:
| Habilidad | Descripción | Instalación |
|---|---|---|
p-video-replace | Úsala cuando alguien quiera intercambiar una persona, vestimenta o producto dentro de un metraje existente manteniendo el movimiento de cámara y el audio. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-image-edit | Úsala cuando alguien quiera editar una foto existente — cambiar vestimenta o fondos, componer a partir de imágenes de referencia o aplicar ediciones guiadas por prompt. | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
video-editing | Úsala para ensamblar o pulir clips ya renderizados con ffmpeg — concatenar, fundidos cruzados, subtítulos y leyendas quemados, superposiciones de texto/logotipo, controles deslizantes antes/después, pistas musicales de fondo, exportación para plataformas — o para componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, elaboración de prompts ni ediciones de video basadas en modelos. | npx skills add PrunaAI/pruna-skills@video-editing -y |