Ir al contenido principal

pruna-ai/p-video-2-pro-replace/video-edit

P-Video 2 Pro Replace de Pruna AI reemplaza hasta a dos personas en videos de hasta 120 segundos, con una foto de referencia por persona. La escena y el movimiento se mantienen, la banda sonora original se conserva por defecto y la resolución va de 480p a 4K.

Desde $0.06/s

Playground

Enviar una solicitud

Inicio rápido

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 integraciones
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticación de API

Guarda 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
Resultado de ejemploUsar este ejemplo
# 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-replace/video-edit",
  "input": {
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "resolution": "768p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# 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.

Parámetros de entrada

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.

reference_image_urlsarray<string>Obligatorio

Obligatorio: una o dos fotos con una persona en cada una. Una foto se asigna a la persona principal; dos se asignan de izquierda a derecha salvo que el prompt indique otra distribución. Si hay una tercera foto, se ignora.

Valor predeterminado
Sin especificar
Restricciones
minItems:1
maxItems:2
video_urlstringObligatorioAfecta al precio

Video de origen obligatorio en MP4, MOV o WebM, de 1–120 segundos y hasta 8K. Si dura más, se recorta a 120 segundos. Este video determina la duración y la relación de aspecto, sin controles independientes.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
contentMediaType:["video/mp4","video/webm","video/quicktime"]
seedintegerOpcional

Número entero opcional para comparar resultados cambiando una entrada por vez. Reutilizarlo no garantiza que todos los fotogramas coincidan con una ejecución anterior.

Valor predeterminado
Sin especificar
Restricciones
minimum:0
maximum:2147483647
ignore_source_audiobooleanOpcional

Desactivado por defecto para permitir que el modelo escuche el video original. Según Pruna, esto guía la sincronización del habla del reemplazo. Actívalo para deshabilitar esa guía; keep_original_audio permite conservar la grabación de todos modos.

Valor predeterminado
false
keep_original_audiobooleanOpcional

Activado por defecto para conservar la grabación original. En nuestras pruebas, desactivarlo produjo un resultado sin pista de audio. Este ajuste no determina si se usa el sonido para sincronizar el habla.

Valor predeterminado
true
resolutionstringOpcionalAfecta al precio

Elige 480p o 768p (predeterminado) para generación directa. 1080p, 2K y 4K se reescalan a partir del resultado de 768p y tardan más. Estos niveles agregan píxeles y nitidez, sin generar detalles adicionales con el modelo; la resolución determina la tarifa de facturación. Los valores de API para 2K y 4K son 2k y 4k.

Valor predeterminado
"768p"
Valores permitidos
"480p""768p""1080p""2k""4k"
promptstringOpcional

Instrucciones opcionales para elegir a la persona del video, asignar cada foto e indicar qué debe conservarse. Por ejemplo: “Primera foto para el ciclista de azul; segunda foto para el ciclista de rojo”. Para una sola persona, puedes dejar vacío el prompt.

Valor predeterminado
Sin especificar
Restricciones
maxLength:2000

Seguir la tarea

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.

Solicitud aceptada
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.

Consultar la tarea
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.

O recibe el resultado por callback
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.

Leer el resultado

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.

Ejemplo de respuesta completada
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "pruna-ai/p-video-2-pro-replace/video-edit",
    "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.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca P-Video 2 Pro Replace · Video Person Replacement 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-spicyapi