Guida introduttiva a P-Video 2 Pro Replace: sostituisci le persone in un video con 1–2 foto

P-Video 2 Pro Replace è il modello di sostituzione persone di Pruna AI: gli fornisci un video sorgente e 1–2 foto di persone, e mantiene azioni, inquadratura, scena e audio del video originale, sostituendo le persone nel filmato con quelle delle foto. Questo articolo spiega chiaramente cosa può fare, come chiamarlo, come si calcola il costo e quando conviene usare un altro modello.

Cosa può fare

• Basta un video e una foto per sostituire una persona: i soli campi obbligatori sono il video sorgente video_url e le foto delle persone image_urls; non serve addestrare prima un'identità.
• Sostituisce al massimo due persone: image_urls accetta 1–2 foto (jpg, jpeg, png, webp), una per persona, e con due persone una foto ciascuna.
• Tutto del video originale viene preservato: azioni, movimento di camera, scena e durata seguono il video sorgente. keep_audio è attivo per impostazione predefinita e l'output include l'audio del video originale; impostandolo su false l'output non contiene l'audio originale.
• Cinque livelli di risoluzione: 480p, 768p, 1080p, 2k, 4k; impostazione predefinita 768p, mantenendo le proporzioni del video sorgente.
• Prompt opzionale: prompt (massimo 1000 caratteri) descrive come inserire le persone delle foto nella scena; la generazione funziona anche senza.

Requisiti di input

• Video sorgente: MP4, MOV o WebM, durata 2–30 secondi. I video fuori intervallo vengono rifiutati al momento dell'invio senza addebito; per materiali più lunghi, tagliare prima in clip entro i 30 secondi.
• Foto delle persone: 1–2, link HTTPS.
• Il filtro di sicurezza dei contenuti è attivo per impostazione predefinita; i contenuti non conformi falliscono restituendo CONTENT_POLICY_VIOLATION e il costo viene rimborsato per intero.

Come chiamarlo

Invia un'attività asincrona e, dopo aver ottenuto il taskId, esegui il polling del risultato:

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"

Al termine dell'attività, output contiene l'indirizzo del video, con durata identica al video sorgente.

Prezzi

La fatturazione si basa sulla durata del video di output; le frazioni inferiori a 1 secondo non vengono addebitate. Il prezzo è lo stesso con 1 o 2 foto:

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

Ad esempio, un video 768p di 10 secondi costa circa $0.72, mentre un 480p di 30 secondi circa $1.07. All'invio viene prelevato un importo provvisorio basato su 30 secondi; al termine si regola il conto in base alla durata effettiva del video, restituendo l'eccedenza. Le attività fallite vengono rimborsate per intero.

Come ottenere risultati migliori

• Se nel video sorgente le persone sono nitide e i movimenti fluidi, e nelle foto il viso frontale è chiaro con luce uniforme, la sostituzione risulta più stabile.
• Verifica prima l'effetto con una clip breve a 480p, poi genera il video finale ad alta risoluzione.
• Per risultati riproducibili, passa seed (un intero da 0 a 2147483647); con gli stessi input aiuta a riprodurre l'output.

Quando scegliere un altro modello

• Se vuoi cambiare lo stile visivo, la scena o l'inquadratura: questo modello sostituisce solo le persone e tutto il resto segue il video sorgente; scegli un modello di editing video.
• Se non hai un video sorgente ma solo un ritratto e una battuta: usa P-Video 2 Pro Avatar della stessa serie per generare un video con parlato in primo piano.

Per provare direttamente l'effetto, puoi caricare un breve video e una foto di una persona su HiAPI Playground e generare.