P-Video 2 Pro Replace – Einstiegsleitfaden: Personen in einem Video mit 1–2 Fotos ersetzen

P-Video 2 Pro Replace ist ein Video-Personentausch-Modell von Pruna AI: Man übergibt ihm ein Quellvideo und 1–2 Personenfotos, und es behält Bewegung, Kameraführung, Szene und Ton des Originalvideos bei und ersetzt die Personen im Bild durch die Personen auf den Fotos. Dieser Artikel erklärt klar, was es kann, wie man es aufruft, wie die Kosten berechnet werden und wann man besser ein anderes Modell wählt.

Was es kann

• Personentausch mit einem Video und einem Foto: Pflichtfelder sind nur das Quellvideo video_url und die Personenfotos image_urls; ein vorheriges Training des Aussehens ist nicht nötig.
• Bis zu zwei Personen ersetzen: image_urls enthält 1–2 Fotos (jpg, jpeg, png, webp), eine Person ein Foto, bei zwei Personen je ein Foto pro Person.
• Alles aus dem Quellvideo bleibt erhalten: Bewegung, Kamerabewegung, Szene und Dauer folgen dem Quellvideo. keep_audio ist standardmäßig aktiviert, die Ausgabe enthält den Ton des Originalvideos; bei false enthält die Ausgabe keinen Originalton.
• Fünf Auflösungsstufen: 480p, 768p, 1080p, 2k, 4k, Standard ist 768p; das Seitenverhältnis des Quellvideos bleibt erhalten.
• Optionaler Prompt: prompt (maximal 1000 Zeichen) beschreibt, wie die Person auf dem Foto in das Bild eingefügt werden soll; die Generierung funktioniert auch ohne.

Eingabeanforderungen

• Quellvideo: MP4, MOV oder WebM, Dauer 2–30 Sekunden. Videos außerhalb dieses Bereichs werden bei der Übermittlung abgelehnt, ohne Berechnung; längere Materialien sollten zunächst auf einen Ausschnitt von höchstens 30 Sekunden gekürzt werden.
• Personenfotos: 1–2 Stück, HTTPS-Links.
• Die Inhaltsfilterung ist standardmäßig aktiviert; regelwidrige Inhalte schlagen fehl und geben CONTENT_POLICY_VIOLATION zurück, die Kosten werden vollständig erstattet.

So wird es aufgerufen

Asynchrone Aufgabe übermitteln, taskId erhalten und dann das Ergebnis abfragen:

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"

Nach erfolgreicher Aufgabe enthält output die Video-Adresse; die Dauer entspricht dem Quellvideo.

Preise

Die Abrechnung erfolgt nach der Dauer des Ausgabevideos, angefangene Sekunden unter 1 Sekunde werden nicht berechnet; ob 1 oder 2 Fotos verwendet werden, ist preisgleich:

• 480p: $0,0358/Sekunde
• 768p: $0,0715/Sekunde
• 1080p: $0,0858/Sekunde
• 2k: $0,1000/Sekunde
• 4k: $0,1286/Sekunde

Zum Beispiel kostet ein 10-Sekunden-Video in 768p etwa $0,72, ein 30-Sekunden-Video in 480p etwa $1,07. Bei der Übermittlung wird zunächst für 30 Sekunden vorab berechnet, nach Abschluss wird nach der tatsächlichen Videodauer abgerechnet, zu viel Berechnetes wird erstattet. Fehlgeschlagene Aufgaben werden vollständig erstattet.

So gelingt die Nutzung besser

• Sind die Personen im Quellvideo deutlich zu sehen und die Bewegungen flüssig sowie die Gesichter auf den Fotos klar und die Beleuchtung gleichmäßig, wird das Ergebnis stabiler.
• Zunächst mit einem kurzen 480p-Ausschnitt das Ergebnis prüfen, dann mit hoher Auflösung das fertige Video erzeugen.
• Wenn ein festes Ergebnis gewünscht ist, seed übergeben (Ganzzahl von 0–2147483647); in Kombination mit identischen Eingaben hilft dies, das Ergebnis zu reproduzieren.

Wann man besser ein anderes Modell wählt

• Wenn Bildstil, Szene oder Kameraführung verändert werden sollen: Dieses Modell tauscht nur Personen aus, alles andere folgt dem Quellvideo; hierfür bitte ein Videobearbeitungsmodell wählen.
• Wenn kein Quellvideo vorliegt, sondern nur ein Porträt und ein Sprechtext: Mit dem P-Video 2 Pro Avatar derselben Serie ein Sprechvideo generieren.

Um das Ergebnis direkt auszuprobieren, kann man im HiAPI Playground ein kurzes Video und ein Personenfoto hochladen und generieren.