pruna-ai/p-video-2-pro/reference-to-videoLa función de referencia a video de P-Video 2 Pro construye un clip de 5 a 15 segundos a 480p o 768p a partir de hasta 3 videos de referencia y 3 clips de audio, nombrados en el prompt como video 1 y audio 1, más un cuadro de apertura y de cierre opcionales. Sin filtro de contenido.
Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.
SDK e integracioneshttps://api.spicyapi.ai/api/v1/jobs/createTaskGuarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.
Authorization: Bearer $SPICY_API_KEY# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pruna-ai/p-video-2-pro/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"generation_mode": "speed",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"prompt_optimization_mode": "off",
"resolution": "768p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.
Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.
promptstringObligatorioDi qué tomar de cada referencia. Escribe video 1, video 2 para los videos de referencia y audio 1, audio 2 para los clips de audio, numerados en el orden en que los subiste.
seedintegerOpcionalMantiene comparables las ejecuciones mientras cambias el prompt. No garantiza un clip con cuadros idénticos.
prompt_optimization_modestringOpcionaloff (por defecto) envía tu prompt palabra por palabra; turbo y max hacen que el servicio lo reescriba primero. No cambia el precio.
"off""turbo""max"duration_secondsintegerOpcionalAfecta al precioSegundos enteros, de 5 a 15 (por defecto 5). Define el precio.
keep_reference_audiobooleanOpcionalDesactivado por defecto. Activado usa tu clip de audio como pista de sonido en lugar de generar sonido nuevo; requiere exactamente un clip de audio.
generation_modestringOpcionalAfecta al preciocost (más barato, un poco más lento) o speed (por defecto, más rápido con la misma calidad).
"cost""speed"resolutionstringOpcionalAfecta al precio480p o 768p (por defecto 768p). 768p cuesta más por segundo.
"480p""768p"aspect_ratiostringOpcionalauto (por defecto) se adapta a las referencias; o elige 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 o 1:1. No cambia el precio.
"auto""16:9""9:16""4:3""3:4""3:2""2:3""1:1"reference_audio_urlsarray<string>OpcionalAfecta al precioHasta 3 clips de audio, 15 segundos en total, para una voz, un diálogo o música. Necesita también un cuadro de apertura o un video de referencia. Añade un cargo fijo.
reference_video_urlsarray<string>OpcionalAfecta al precioHasta 3 videos, de 2 segundos o más cada uno y 15 segundos en total, para movimiento, cámara y ritmo. Sus segundos se cobran, más un segundo para redondeo.
last_image_urlstringOpcionalAfecta al precioCuadro de cierre opcional en el que termina el clip. Añade un pequeño cargo.
image_urlstringOpcionalAfecta al precioCuadro de apertura opcional: quién y dónde empieza la toma. Añade un pequeño cargo.
{
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"default": "auto",
"description": "Output aspect ratio; auto adapts to the references.",
"enum": [
"auto",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"1:1"
],
"type": "string",
"x-ui": {
"order": 80,
"widget": "select"
}
},
"duration_seconds": {
"default": 5,
"description": "Output length in whole seconds, from 5 to 15. Billed per second.",
"maximum": 15,
"minimum": 5,
"type": "integer",
"x-ui": {
"affects_price": true,
"order": 60,
"step": 1,
"unit": "s",
"widget": "slider"
}
},
"generation_mode": {
"default": "speed",
"description": "cost is cheaper and slower, speed (the default) is faster at the same quality.",
"enum": [
"cost",
"speed"
],
"type": "string",
"x-ui": {
"affects_price": true,
"order": 65,
"widget": "radio"
}
},
"image_url": {
"contentMediaType": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif"
],
"description": "Optional opening frame. Adds a small per-image charge.",
"format": "uri",
"type": "string",
"x-ui": {
"affects_price": true,
"order": 92,
"widget": "upload"
}
},
"keep_reference_audio": {
"default": false,
"description": "Use the reference audio as the soundtrack instead of generating new sound. Needs exactly one audio clip.",
"type": "boolean",
"x-ui": {
"order": 63,
"widget": "switch"
}
},
"last_image_url": {
"contentMediaType": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif"
],
"description": "Optional closing frame. Adds a small per-image charge.",
"format": "uri",
"type": "string",
"x-ui": {
"affects_price": true,
"order": 91,
"widget": "upload"
}
},
"prompt": {
"description": "Say what the shot should take from each reference. Refer to reference videos as video 1, video 2 and to audio clips as audio 1, audio 2, numbered in upload order.",
"minLength": 1,
"type": "string",
"x-ui": {
"order": 100,
"primary": true,
"reference_tokens": {
"reference_audio_urls": "audio {index}",
"reference_video_urls": "video {index}"
},
"widget": "textarea"
}
},
"prompt_optimization_mode": {
"default": "off",
"description": "Let the service rewrite and expand the prompt first: off follows it word for word, turbo is a quick rewrite, max a fuller one. Does not change the price.",
"enum": [
"off",
"turbo",
"max"
],
"type": "string",
"x-ui": {
"advanced": true,
"affects_price": false,
"order": 30,
"widget": "radio"
}
},
"reference_audio_urls": {
"description": "Reference audio for a voice, dialogue or music: up to 3 clips, 15 seconds in total. Needs an opening frame or a reference video as well. Refer to them as audio 1, audio 2.",
"items": {
"contentMediaType": [
"audio/mpeg",
"audio/wav"
],
"format": "uri",
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"x-ui": {
"accept": [
"audio/mpeg",
"audio/wav"
],
"affects_price": true,
"max_total_duration_seconds": 15,
"order": 88,
"widget": "multi-upload"
}
},
"reference_video_urls": {
"description": "Reference videos for motion, camera and pacing: up to 3, 2 seconds or longer each and 15 seconds in total. Refer to them as video 1, video 2. Their seconds are billed too.",
"items": {
"contentMediaType": [
"video/mp4",
"video/webm",
"video/quicktime"
],
"format": "uri",
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"x-ui": {
"accept": [
"video/mp4",
"video/webm"
],
"affects_price": true,
"max_total_duration_seconds": 15,
"order": 90,
"widget": "multi-upload"
}
},
"resolution": {
"default": "768p",
"description": "Output resolution. 768p costs more per second than 480p.",
"enum": [
"480p",
"768p"
],
"type": "string",
"x-ui": {
"affects_price": true,
"order": 70,
"widget": "radio"
}
},
"seed": {
"description": "Random seed for controlled comparisons, not a frame-identical guarantee.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer",
"x-ui": {
"order": 10,
"widget": "number"
}
}
},
"required": [
"prompt"
],
"type": "object",
"x-pricing": {
"billingMode": "formula",
"variantFields": [
"generation_mode",
"resolution"
]
}
}HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}La respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
--data-urlencode "taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.
import { verifyWebhook } from "@spicyapi/sdk";
// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
const { payload } = verifyWebhook({
rawBody: req.body,
timestamp: req.header("X-Webhook-Timestamp"),
signature: req.header("X-Webhook-Signature"),
payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
secret: process.env.SPICY_WEBHOOK_SECRET,
});
res.status(200).end();
void handleFinishedTask(payload);
});Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.
Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.
{
"code": 200,
"msg": "success",
"request_id": "req_example_record",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "pruna-ai/p-video-2-pro/reference-to-video",
"state": "succeeded",
"output": {
"assets": [
{
"key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
"mime": "video/mp4",
"url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
"expiresAt": "2026-08-28T12:20:08.000Z"
}
]
},
"cost": "0.750000",
"settled": true,
"createdAt": "2026-08-28T12:00:00Z",
"completedAt": "2026-08-28T12:00:30Z"
}
}Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.
Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.
No hace falta que escribas nada del código anterior. Conecta el servidor MCP una vez y cualquier agente que use MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — podrá ejecutar este modelo por su nombre. También puedes ejecutarlo desde tu terminal con un solo comando.
Use pruna-ai/p-video-2-pro/reference-to-video to make a five-second shot of a neon-lit rooftop at dusk, slow push-in, and save it to ./out/.
El agente busca el modelo en el catálogo actualizado, sube el archivo local por ti, te muestra la cotización exacta y el cargo máximo, y espera tu confirmación. No se cobra nada hasta que aceptes.
claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillLa primera línea le da las herramientas al agente; la segunda le da el Skill, las reglas para usarlas: consultar la cotización antes de cobrar, subir los archivos locales en lugar de pegar sus bytes y leer la URL del resultado en vez de adivinarla. Los demás clientes usan el mismo servidor desde su propio archivo de configuración: consulta el área de desarrolladores.
npx @spicyapi/cli tasks create --model pruna-ai/p-video-2-pro/reference-to-video \
--input-json '{"aspect_ratio":"auto","duration_seconds":5,"generation_mode":"speed","prompt":"A slow aerial shot drifting over a misty pine forest at sunrise","prompt_optimization_mode":"off","resolution":"768p"}' \
--waitLa entrada usa el esquema de este endpoint, igual que los ejemplos de arriba. --wait consulta el estado hasta que la tarea termina y lo imprime; agrega --yes para omitir la confirmación en CI. Define antes SPICY_API_KEY: una misma clave sirve para la API, la CLI y el servidor MCP.
npx @spicyapi/cli tasks create --model pruna-ai/p-video-2-pro/reference-to-video \
--input-json '{…}' --retention 1h --wait
npx @spicyapi/cli tasks get $TASK_ID # read back the retention that applied--retention solo acorta el plazo: 30m, 1h, 7d, o 0 para borrar en cuanto la tarea llega a un estado final. Se aplica el plazo más corto entre tu solicitud, los ajustes de tu cuenta y el máximo de la plataforma. Consúltalo en el registro de la tarea en vez de asumir que se aplicó el plazo que pediste. Pedir más tiempo del que permite tu cuenta no tiene efecto.
Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca P-Video 2 Pro · Reference to Video en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapiEl panel incrustado lee el mismo esquema que esta página, así que no puede desincronizarse de la API. Si tu documentación necesita contenido indexable, toma el JSON de /api/embed/models/ y renderízalo tú mismo.
<iframe src="https://spicyapi.ai/embed/es/models/p-video-2-pro/api?model=pruna-ai%2Fp-video-2-pro%2Freference-to-video" width="100%" height="560" loading="lazy" title="Ejemplo de solicitud" style="border:1px solid rgba(0,0,0,.12)"></iframe>