Video Face Swap API

Video Face Swap überträgt die Gesichtszüge aus einem einzelnen Referenzbild auf die Person in einem Video, und zwar durch jedes Bild des Clips hindurch. Es wandern nur die Gesichtszüge: Frisur, Kopfsilhouette, Bewegung, Kleidung, Licht, Kameraführung und Hintergrund bleiben so, wie sie gedreht wurden. Deshalb wirkt das Ergebnis wie die ursprüngliche Aufnahme und nicht wie eine aufgelegte Ebene.

Video Face Swap nimmt einen Videoclip und ein Referenzgesicht entgegen und überträgt nur die Gesichtszüge auf die Person in der Aufnahme – Haare, Bewegung, Bildausschnitt und Hintergrund bleiben erhalten. Zwei URLs und eine optionale Anmutung, ein Prompt-Feld gibt es nicht.

Performance bewahren, Gesichtsidentität ändern

Face Swap überträgt die Identität aus der freigegebenen Referenz auf die Person im gelieferten Material und erhält die Live-Action-Performance. Wählen Sie einen Clip, dessen Motiv, Bildausschnitt und Licht bereits stimmen, denn dieser Ablauf ersetzt Identität statt eine Einstellung neu aufzubauen.

Kontinuität prüfen, nicht eine neue Szene

Bewerten Sie das Ergebnis bei normaler Wiedergabegeschwindigkeit über Drehungen, Schnitte und schnelle Bewegungen hinweg. Prüfen Sie, ob die Übertragung stimmig bleibt und Haare, Bewegung, Kleidung und Hintergrund weiterhin wie das Originalmaterial lesbar sind.

Einen vorhandenen Clip bearbeiten

Video Face Swap überträgt die Gesichtszüge aus einem einzelnen Referenzbild auf die Person in einem Video, und zwar durch jedes Bild des Clips hindurch. Es wandern nur die Gesichtszüge: Frisur, Kopfsilhouette, Bewegung, Kleidung, Licht, Kameraführung und Hintergrund bleiben so, wie sie gedreht wurden. Deshalb wirkt das Ergebnis wie die ursprüngliche Aufnahme und nicht wie eine aufgelegte Ebene. Nutzen Sie diesen Modus, wenn ein Quellvideo der Ausgangspunkt einer Bearbeitung sein soll. Beschreiben Sie die Änderung präzise und prüfen Sie Kontinuität, Timing und die zu bewahrenden Details.

Ein Gesicht für eine ganze generierte Serie

Erzeugen Sie mit einem beliebigen Videomodell eine Reihe von Clips und übertragen Sie dann ein freigegebenes Gesicht auf alle, damit die Serie als dieselbe Person wirkt. Bewegung, Kleidung und Set bleiben in jedem Clip erhalten, die generierte Vielfalt überlebt also den Durchgang.

Unzensierte Inhalte mit dem Abbild einer einwilligenden Person

Übertragen Sie ein Gesicht, das Sie nutzen dürfen, auf Material, das Sie selbst produziert haben. Für unzensiertes Material ändert sich an der Anfrage nichts – die Berechtigungspflicht in den Grenzen unten ist aber eine harte Bedingung, keine Formalität.

Eine gelungene Aufnahme neu besetzen

Behalten Sie einen Take, dessen Licht, Blocking und Kamerabewegung bereits abgenommen sind, und setzen Sie ein anderes Gesicht ein, statt die ganze Einstellung neu zu generieren und die vorhandene Performance zu verlieren.

# 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": "spicyapi/face-swap-video-v1/video-edit",
  "input": {
    "reference_image_url": "https://example.com/reference.png",
    "style": "realistic",
    "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"

Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.