Guía de inicio de P-Video 2 Pro Replace: reemplaza a las personas de un video con 1–2 fotos

P-Video 2 Pro Replace es el modelo de cambio de personas en video de Pruna AI: le das un video de origen y 1–2 fotos de personas, y conserva los movimientos, la cámara, la escena y el audio del video original mientras reemplaza a las personas del metraje por las de las fotos. Este artículo explica qué puede hacer, cómo se llama, cómo se calcula el costo y cuándo conviene usar otro modelo.

Qué puede hacer

• Basta un video y una foto para cambiar a una persona: los únicos campos obligatorios son el video de origen video_url y las fotos de personas image_urls; no hace falta entrenar un rostro primero.
• Hasta dos personas: image_urls admite 1–2 fotos (jpg, jpeg, png, webp); una foto por persona, y una cada una cuando son dos.
• Todo lo del video original se conserva: los movimientos, el movimiento de cámara, la escena y la duración siguen al video de origen. keep_audio está activado por defecto y la salida incluye el audio del video original; si se define en false, la salida no lleva el audio original.
• Cinco niveles de resolución: 480p, 768p, 1080p, 2k y 4k; por defecto 768p, manteniendo la relación de aspecto del video de origen.
• Prompt opcional: prompt (máximo 1000 caracteres) indica cómo integrar en la escena a la persona de la foto; también se puede generar sin escribirlo.

Requisitos de entrada

• Video de origen: MP4, MOV o WebM, con una duración de 2–30 segundos. Los videos fuera de ese rango se rechazan al enviarlos y no se cobran; si el material es más largo, córtalo primero en fragmentos de hasta 30 segundos.
• Fotos de personas: 1–2, con enlace HTTPS.
• El filtro de seguridad de contenido está activado por defecto; el contenido infractor falla y devuelve CONTENT_POLICY_VIOLATION, con reembolso total del costo.

Cómo llamarlo

Envía una tarea asíncrona y, tras obtener el taskId, consulta el resultado en bucle:

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "p-video-2-pro-replace",
    "input": {
      "video_url": "https://example.com/source.mp4",
      "image_urls": ["https://example.com/person.jpg"],
      "resolution": "768p",
      "keep_audio": true
    }
  }'

curl https://api.hiapi.ai/v1/tasks/<taskId> \
  -H "Authorization: Bearer $HIAPI_KEY"

Cuando la tarea se completa con éxito, output contiene la dirección del video, cuya duración coincide con la del video de origen.

Precios

Se cobra por la duración del video de salida; las fracciones inferiores a 1 segundo no se cobran. El precio es el mismo tanto si se ponen 1 como 2 fotos:

• 480p: $0.0358/segundo
• 768p: $0.0715/segundo
• 1080p: $0.0858/segundo
• 2k: $0.1000/segundo
• 4k: $0.1286/segundo

Por ejemplo, un video de 10 segundos en 768p cuesta aproximadamente $0.72, y uno de 30 segundos en 480p, unos $1.07. Al enviar se retiene primero el importe correspondiente a 30 segundos; al terminar se liquida según la duración real del video y se devuelve el excedente. Las tareas fallidas se reembolsan por completo.

Cómo obtener mejores resultados

• Si en el video de origen las personas se ven nítidas y los movimientos son continuos, y en las fotos el rostro frontal se ve claro y la iluminación es uniforme, el reemplazo resulta más estable.
• Primero confirma el resultado con un fragmento corto en 480p y luego genera el video final en alta resolución.
• Si necesitas resultados fijos, pasa seed (un entero de 0 a 2147483647); junto con las mismas entradas ayuda a reproducir el resultado.

Cuándo elegir otro modelo

• Si quieres cambiar el estilo visual, la escena o la cámara: este modelo solo cambia a las personas y todo lo demás sigue al video de origen; elige un modelo de edición de video.
• Si no tienes un video de origen y solo cuentas con un retrato y un guion: usa P-Video 2 Pro Avatar, de la misma serie, para generar un video con locución.

Si quieres probar el resultado directamente, puedes subir un video corto y una foto de una persona en HiAPI Playground para generarlo.