Prerrequisitos
Instala y carga estas skills antes de generar (omite si ya están en contexto mediante @pruna):
| Skill | Descripción | Instalación |
|---|---|---|
generation-diversity | Úsalo al escribir cualquier prompt generativo: semilla ritual, estructura explícita, ejes de escenario y barreras de calidad antes de llamadas a API pagas. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
video-prompting | Úsalo al crear 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 |
audio-prompting | Úsalo al crear prompts TTS, musicales o de ambiente para cualquier modelo de audio generativo: estilo de director, estructura de canción y capas de postproducción. | npx skills add PrunaAI/pruna-skills@audio-prompting -y |
pruna-api | Úsalo antes de cualquier llamada HTTP a Pruna o Replicate: credenciales, subida/sondeo/descarga, lotes paralelos y seguridad del agente. | npx skills add PrunaAI/pruna-skills@pruna-api -y |
O instala el conjunto completo de una vez: npx skills add PrunaAI/pruna-skills@pruna -y
Sigue las secciones Antes de generar / redacción de cada skill — no repliques el contenido de la guía aquí.
Hábito del agente
Enrutamiento: Usa `p-video` para clips simples y rápidos — borradores, B-roll ligero, movimiento corto. Para generación cinematográfica con audio generado → `p-video-2-pro`. Para 1080p, audio importado o previsualizaciones de borrador → `p-video-2`.
En la primera respuesta, nombra `p-video` entre acentos graves, confirma PRUNA_API_KEY (o detente con enlaces de registro de pruna-api), luego pide las entradas requeridas. Apertura → realización de generation-diversity antes del primer POST. Al redactar prompts de movimiento, sigue Redacción de prompt (dinámico + fiel) — no pegues ejemplos de la skill. Redirige cuando CUÁNDO NO usar sea más adecuado.
Redacción de prompt (dinámico + fiel)
Cada input.prompt debe ser fresco y específico y debe coincidir con el ritmo del usuario. La diversidad nunca anula el brief.
| Hacer | No hacer |
|---|---|
Ejecuta el ritual de semilla aleatoria de generation-diversity; menciónalo; rota ≥2 ejes libres (movimiento de cámara, cambio de iluminación, textura, ritmo) cuando el brief lo permita | Copiar ejemplos curl de esta skill ("calle mojada por lluvia", "perro lanza peluche", …) o reutilizar un prompt de una sesión anterior |
Fija primero los hechos requeridos por el usuario (sujeto, ritmo de acción, OPEN/MID/CLOSE cuando esté anclado por fotogramas, sincronización con narración cuando audio esté configurado) | Cambiar el sujeto o movimiento por un clip "más cool" que ignore la solicitud |
Estructura con la dramaturgia de video-prompting — una acción congelada por ritmo, movimiento físicamente seguro, gramática de cámara | Cadenas vagas solo de ambiente ("ambiente cinematográfico, energía neón") |
Cuando audio esté configurado, el movimiento y el ritmo deben coincidir con el ritmo de la narración | Desviarse a una acción no relacionada mientras suena la voz en off |
Muestra el prompt redactado + los campos de modo antes del POST cuando el usuario no haya fijado las palabras | Regeneración silenciosa con un sujeto o ritmo diferente al aprobado |
Comprobación de fidelidad (antes de pagar): si eliminas el sujeto/acción/escenario nombrado por el usuario del prompt, el trabajo está mal — reescribe. Los ejes libres solo llenan lo que el brief dejó abierto.
Al mostrar un prompt redactado, sigue nombrando `p-video` (las guías ayudan a redactar; esta herramienta es la que hace la llamada).
Límite de la skill
Esta skill = una predicción p-video por invocación.
Fuera del alcance (no ejecutar desde esta skill):
- Montaje multi-escena, concatenación, orquestación de subagentes o lotes de escenas paralelas
- Transferencia de movimiento desde un video plantilla →
p-video-animate - Anfitrión solo de cabeza parlante / sincronía labial sin audio de escena nativo →
p-video-avatar - Generación cinematográfica con audio generado →
p-video-2-pro - 1080p, audio importado o previsualizaciones de borrador →
p-video-2
Si la solicitud excede un clip, detente y recomienda: image-to-video (un ritmo narrado), visual-transition-reel (visual multi-escena) o narrated-multi-scene (multi-escena + VO).
CUÁNDO NO usar
Usa una skill diferente en su lugar:
| Skill | Descripción | Instalación |
|---|---|---|
p-video-2-pro | Úsalo cuando se desee un clip cinematográfico a partir de texto o fotogramas inicio/fin — anuncios de producto, tomas documentales o diálogos con audio generado. No para 1080p, pistas de audio importadas o anfitriones solo de cabeza parlante. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | Úsalo cuando se desee un clip corto y pulido a partir de texto, imágenes o audio importado — B-roll en 1080p, animación de fotograma inicio/fin o una toma con movimiento con una pista mixta. No para clips cinematográficos con audio generado o anfitriones solo de cabeza parlante. | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video-avatar | Úsalo cuando se desee una persona en cámara leyendo un guion — anfitrión con sincronía labial, portavoz o avatar narrado a partir de una foto de retrato. | npx skills add PrunaAI/pruna-skills@p-video-avatar -y |
p-video-animate | Úsalo cuando se desee que una foto se mueva como otro video — transferencia de movimiento, remixes de baile o variaciones de rendimiento a partir de un clip plantilla. | npx skills add PrunaAI/pruna-skills@p-video-animate -y |
p-video-replace | Úsalo cuando se desee intercambiar una persona, atuendo 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-edit | Úsalo cuando se desee editar un video existente con una instrucción de texto — recolorizar, reestilizar, eliminar o añadir objetos, cambiar entorno o iluminación, actualizar texto en pantalla o aplicar ediciones opcionales de producto y accesorios guiadas por referencia. No para un clip nuevo desde cero o montaje con ffmpeg. | npx skills add PrunaAI/pruna-skills@p-video-edit -y |
video-editing | Úsalo al ensamblar o pulir clips ya renderizados con ffmpeg — concatenación, encadenados, subtítulos y leyendas quemadas, superposiciones de texto/logo, controles deslizantes antes/después, fondos musicales, exportación para plataformas — o al componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, redacción de prompts o ediciones de video basadas en modelos. | npx skills add PrunaAI/pruna-skills@video-editing -y |
HTTP (curl)
Subida para imagen-a-video / anclajes de fotograma
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/first-frame.png"
Pasa urls.get como input.image (primer fotograma) y/o input.last_frame_image (último fotograma). Sube TTS/música de la misma manera para input.audio.
Crear (texto-a-video 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' \
-d '{
"input": {
"prompt": "Slow dolly in on rain-slick street at night, neon reflections, distant traffic hiss",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}'
Sondea 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.
Primer / último fotograma (transición visual)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video' \
-d '{
"input": {
"prompt": "OPEN: hold wide on wet alley, neon flicker. MID: slow dolly in, rain ticks on pavement. CLOSE: settle on end pose.",
"image": "https://api.pruna.ai/v1/files/START_ID",
"last_frame_image": "https://api.pruna.ai/v1/files/END_ID",
"duration": 5,
"resolution": "720p",
"fps": 24
}
}'
Triple anclaje de escena (image + last_frame_image + audio)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video' \
-d '{
"input": {
"prompt": "Dog tosses plush upward, tail wagging, motion matches narrator, warm light",
"image": "https://api.pruna.ai/v1/files/SCENE_START",
"last_frame_image": "https://api.pruna.ai/v1/files/SCENE_END",
"audio": "https://api.pruna.ai/v1/files/SCENE_NARRATION",
"resolution": "720p",
"fps": 24,
"save_audio": true
}
}'
Omite duration cuando audio esté configurado. La duración del clip = min(longitud del audio, 20s) — mantén TTS ≤ ~19s (ffprobe antes de renderizar).
Antes de generar
- Completa el orden de lectura de los Prerrequisitos (
generation-diversity→video-prompting). - Semilla ritual → redacta un prompt de movimiento dinámico + fiel (sección anterior) → confirma modo (T2V / I2V / par de fotogramas / audio),
duration(a menos que esté guiado por audio),resolution,fps,draftypromptcon el usuario. - Notas de Pruna: cuando
imageestá configurado,aspect_ratiose ignora. Conaudio, omitedurationy establecesave_audio: truepara mantener la narración. Prefiere VO subida sobre post-mux. Si la solicitud es multi-escena — detente (ver Límite de la skill).
Entrada requerida
prompt(cadena)
Campos opcionales comunes
| Campo | Rol |
|---|---|
image | Primer fotograma — anclaje I2V; cuando está configurado, se ignora aspect_ratio |
last_frame_image | Imagen fija de estado final opcional |
audio | Condicionado por audio; la duración sigue al audio (limitado a 20s); flac/mp3/wav |
duration | 1–20s (ignorado si audio está configurado) |
resolution | 720p (predeterminado) o 1080p |
fps | 24 (predeterminado) o 48 |
aspect_ratio | Cuando no hay image: 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 1:1 |
draft | true ≈ vista previa 4× más rápida/barata; false = final |
save_audio | Mantener el audio generado por el modelo o subido en la salida |
seed, prompt_upsampling, disable_safety_filter | Reproducibilidad / política del cliente |
Relacionados
Skills relacionadas:
| Skill | Descripción | Instalación |
|---|---|---|
p-video-2-pro | Úsalo cuando se desee un clip cinematográfico a partir de texto o fotogramas inicio/fin — anuncios de producto, tomas documentales o diálogos con audio generado. No para 1080p, pistas de audio importadas o anfitriones solo de cabeza parlante. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
gemini-3.1-flash-tts | Úsalo cuando se necesite narración hablada o voz en off — pistas explicativas, líneas documentales o voz para emparejar con video generado. | npx skills add PrunaAI/[email protected] -y |
image-to-video | Úsalo cuando se desee un ritmo de cortometraje a partir de imágenes — una escena narrada, momento de historia o B-roll cinematográfico con voz en off opcional. | npx skills add PrunaAI/pruna-skills@image-to-video -y |
visual-transition-reel | Úsalo cuando se desee un montaje con transiciones entre tomas — reel de secuencia de acción o pieza multi-escena donde la narración es opcional. | npx skills add PrunaAI/pruna-skills@visual-transition-reel -y |
narrated-multi-scene | Úsalo cuando se desee una historia en varias partes con voz en off — B-roll episódico, promocional 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 |
p-video-avatar | Úsalo cuando se desee una persona en cámara leyendo un guion — anfitrión con sincronía labial, portavoz o avatar narrado a partir de una foto de retrato. | npx skills add PrunaAI/pruna-skills@p-video-avatar -y |
p-video-animate | Úsalo cuando se desee que una foto se mueva como otro video — transferencia de movimiento, remixes de baile o variaciones de rendimiento a partir de un clip plantilla. | npx skills add PrunaAI/pruna-skills@p-video-animate -y |
video-editing | Úsalo al ensamblar o pulir clips ya renderizados con ffmpeg — concatenación, encadenados, subtítulos y leyendas quemadas, superposiciones de texto/logo, controles deslizantes antes/después, fondos musicales, exportación para plataformas — o al componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, redacción de prompts o ediciones de video basadas en modelos. | npx skills add PrunaAI/pruna-skills@video-editing -y |