Pruna AI
P-Video 2 Pro Replace
p-video-2-pro-replace
Das Charakterersetzungs-Videomodell von Pruna AI platziert Personen mithilfe von ein bis zwei Referenzbildern in ein bestehendes Video, ersetzt bis zu zwei Personen gleichzeitig, behält Kameraführung, Bildkomposition, Hintergrund und Bewegungen des Originalvideos bei und kann die Quell-Tonspur übernehmen – ideal für Werbevarianten und lokalisierte Sprecheraufnahmen
p-video-2-pro-replace ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
p-video-2-pro-replace per second
| Spezifikationen | Einzelpreis |
|---|---|
| 480P | $0.0358 |
| 768P | $0.0715 |
| 1080P | $0.0858 |
| 2K | $0.100 |
| 4K | $0.1286 |
Positionsprofil
Dies ist ein Video-Ersetzungswerkzeug für die Videopostproduktion und die Erstellung von Marketingmaterialien: Laden Sie ein Quellvideo und ein bis zwei Personenreferenzbilder hoch, und die Personen aus den Bildern werden in die Szene des Originalvideos eingefügt, während Kameraführung, Bildkomposition, Hintergrund und Bewegungsrhythmus des Originals erhalten bleiben. Ein Prompt kann die Art der Platzierung der Personen ergänzen oder leer gelassen werden, um die natürliche Darstellung des Quellvideos beizubehalten. Geeignet für Werbevarianten, lokalisierte Auftrittsversionen und die Neubesetzung von Rollen in bestehendem Material; die Ausgabe ist eine Videodatei, die im Seitenverhältnis des Quellbildes geliefert werden kann.
Hauptmerkmale
- Personen ersetzen, Originalszene beibehalten – Nach dem Ersetzen werden Kameraführung, Bildkomposition, Hintergrund und Bewegungsrhythmus des Quellvideos übernommen, was den Aufwand für Nachdrehs und neues Bühnenbild reduziert.
- Personen anhand von ein bis zwei Referenzbildern festlegen – Unterstützt eine einzelne Person oder zwei Personen, die jeweils mit einem eigenen Bild gleichzeitig ersetzt werden; ideal für die schnelle Erstellung von Varianten mit zwei Personen im Bild.
- Quelldauer und Seitenverhältnis werden übernommen – Die Ausgabedauer folgt dem Quellvideo, das Seitenverhältnis bleibt das des Quellvideos, sodass bestehende Schnitte und Ausspielformate weiterverwendet werden können.
Funktionsbeschreibung
Personen per Referenzbild ersetzen: Mit ein bis zwei HTTPS-Personenbildern können die Personen aus den Bildern in die Szene des Quellvideos eingefügt werden; die beiden Bilder entsprechen jeweils zwei auftretenden Personen und eignen sich für Zweipersonenaufnahmen.
Platzierung per Prompt steuern: Ein optionaler Prompt mit maximal 1000 Zeichen beschreibt, wie die Personen in die Szene eingefügt werden; bleibt er leer, wird die ursprüngliche Darstellung des Quellvideos beibehalten.
Vorgaben für das Quellvideo: Das Quellvideo muss als HTTPS-Adresse in den Formaten MP4, MOV oder WebM vorliegen und eine Dauer von 2 bis 30 Sekunden haben; außerhalb dieses Bereichs wird es abgelehnt. Die Ausgabedauer folgt dem Quellvideo.
Auflösungsauswahl: Als Ausgabeformat kann eine von 480p, 768p, 1080p, 2k oder 4k gewählt werden, Standard ist 768p; das Seitenverhältnis übernimmt das des Quellvideos.
Reproduzierbarkeit per Zufalls-Seed: Ein Zufalls-Seed von 0 bis 2147483647 kann festgelegt werden, um bei gleichem Material und gleichen Parametern wiederholt zu generieren und verschiedene Platzierungen der Personen zu vergleichen.
Anwendungsfälle
- Werbeagenturen erstellen Auftrittsvarianten in Serie – Mit demselben Quellvideo und unterschiedlichen Personenreferenzbildern werden Videomaterialien mit mehreren Personenversionen erzeugt, für Ausspielungstests und die Verteilung auf mehreren Plattformen.
- Lokalisierte Marketinginhalte mit ausgetauschten auftretenden Personen – Szene und Rhythmus des Originals bleiben erhalten, die auftretenden Personen werden durch das Erscheinungsbild des Zielmarkts ersetzt, sodass eine lokalisierte Version entsteht, die direkt in bestehende Schnitte eingesetzt werden kann.
- Neubesetzung von Rollen in bestehendem Material – Bereits gedrehtes Material erhält andere auftretende Personen, ohne neues Bühnenbild und neue Dreharbeiten; die Ausgabe ist eine Videodatei, die sich zum Weiterschneiden und Ausliefern eignet.
- Gleichzeitiges Ersetzen in Zweipersonenaufnahmen – Für beide Personen wird jeweils ein Referenzbild bereitgestellt, und in einem Durchgang entsteht eine Version mit zwei Personen, für die Erstellung von Mehrpersonenmaterial in sozialen Kurzvideos.
Einschränkungen und Auswahlhinweise
Pro Durchgang können höchstens zwei Personen ersetzt werden; das Quellvideo muss 2 bis 30 Sekunden lang sein, kürzere oder längere Videos werden abgelehnt, und die Ausgabedauer folgt dem Quellvideo. Es müssen stets sowohl das Quellvideo als auch mindestens ein Referenzbild bereitgestellt werden; eine reine Text-zu-Video-Generierung von Grund auf ist nicht möglich. Wird die Option zum Beibehalten des Quellaudios deaktiviert, wird die Originaltonspur nicht übernommen, und der Ton der finalen Version muss selbst geprüft werden. Das Ersetzungsergebnis hängt von den Bedingungen der Referenzbilder und des Quellvideobildes ab; ein völlig identisches Aussehen der Personen ist nicht garantiert.
Neuigkeiten
Changelog ansehen →- Neues Modell P-Video 2 Pro Replace ist online: Ersetze Personen in Videos mit 1–2 Fotos
Häufige Fragen
Alle Fragen ansehen →-
Wie viele Personen im Bild können maximal ersetzt werden?
Maximal zwei Personen. In image_urls 1–2 Personenfotos einfügen: bei einer Person ein Foto, bei zwei Personen je ein Foto pro Person. Mit prompt lässt sich ergänzen, wie die Personen in das Bild eingefügt werden sollen.
-
Wie lang darf das Quellvideo sein?
Derzeit werden nur Quellvideos mit einer Länge von 2 bis 30 Sekunden akzeptiert; Anfragen außerhalb dieses Bereichs werden abgelehnt. Die Ausgabedauer entspricht der des Quellvideos und wird nicht separat angegeben; ist das Material länger, muss es zunächst selbst zugeschnitten oder in Abschnitte unterteilt und jeweils separat verarbeitet werden.
-
Ändern sich beim Ersetzen Kamera und Hintergrund?
Nein, Kamerabewegung, Bildkomposition, Hintergrund und zeitlicher Rhythmus werden vollständig vom Quellvideo übernommen, das Modell ersetzt nur die Person. Auch über Parameter lässt sich die Aufnahmeart nicht ändern; für eine andere Kameraposition oder Szene ist ein anderes Quellvideo nötig.
-
Kann der Ton des Originalvideos beibehalten werden?
Ja, standardmäßig wird der Ton beibehalten: keep_audio ist standardmäßig true, die Ausgabe enthält dann die Tonspur des Quellvideos. Bei false wird die Ausgabe ohne Originalton erzeugt.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: p-video-2-pro-replace
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für p-video-2-pro-replace und Route default — siehe Parametertabelle unten.
seedintegerOptionalmin 0max 2147483647Zufälliger Startwert, ganze Zahl von 0–2147483647; die Übergabe desselben Startwerts bei sonst unveränderten Eingaben hilft, Ergebnisse zu reproduzieren; wird kein Wert übergeben, ist er zufällig.
promptstringOptionalmaxLength 1000Optionale Anweisung, die beschreibt, wie die Person aus dem Referenzbild in die Szene eingefügt werden soll; bleibt sie leer, werden Inhalt und Bildkomposition des Quellvideos direkt befolgt.
video_urlstringPflichtpattern ^https://HTTPS-URL des Quellvideos, unterstützt die Formate MP4, MOV und WebM, die Dauer muss 2–30 Sekunden betragen und es liefert Bewegung, Szene, Kameraführung und Audio; Anfragen außerhalb dieses Dauerbereichs werden abgelehnt, die Ausgabedauer entspricht der des Quellvideos.
image_urlsarrayPflichtminItems 1maxItems 2Array von HTTPS-URLs der Identitätsbilder der Personen, die in das Video eingefügt werden sollen, unterstützt jpg, jpeg, png und webp; 1–2 Bilder übergeben, die einer Person entsprechen können oder je ein Bild für zwei Personen.
Array [ string ]
keep_audiobooleanOptionalStandard: trueOb das Audio des Quellvideos in der Ausgabe beibehalten wird; boolescher Wert, Standard true.
resolutionstringOptionalStandard: "768p"Ausgabeauflösung, wählbar aus 480p, 768p, 1080p, 2k, 4k, Standard 768p, das Seitenverhältnis des Quellvideos bleibt erhalten; je höher die Auflösung, desto höher die Kosten.
480p768p1080p2k4kcallbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "p-video-2-pro-replace",
"input": {
"video_url": "…",
"image_urls": "…",
"keep_audio": true,
"resolution": "768p"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "p-video-2-pro-replace",
input: {
"video_url": "…",
"image_urls": "…",
"keep_audio": true,
"resolution": "768p"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "p-video-2-pro-replace",
"input": {
"video_url": "…",
"image_urls": "…",
"keep_audio": True,
"resolution": "768p"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
HeyGen Avatar IV HeyGen $0.150 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
FLUX 3 Max Black Forest Labs $0.121 /Sekunde -
Vidu Q3 Vidu $0.149 /Sekunde -
Seedance 2.5 ByteDance $0.121 /Sekunde -
Wan 2.7 Video Alibaba $0.100 /Sekunde -
Runway Gen 4.5 Runway $0.172 /Sekunde -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde -
Kling 4.0 Kuaishou $0.204 /Sekunde -
Gemini Omni 1.1 Google $0.450 /Video -
HappyHorse 1.1 Alibaba $0.160 /Sekunde -
Kling 3.0 Kuaishou $0.100 /Sekunde
