Video Head Swap API

Video Head Swap nimmt die Task-ID einer Analyse, die aus deren Vorschaubildern gewählten Positionen und je ein bis drei Referenzfotos entgegen und gibt den Clip mit ersetzten Köpfen zurück. Haar, Kopfform und Identität ändern sich; Körper, Kleidung, Bewegung, Bildausschnitt und Originaltonspur bleiben so, wie sie gedreht wurden. Nicht aufgeführte Köpfe bleiben unangetastet.

Video Head Swap läuft in zwei Aufrufen. Der erste verfolgt jeden Kopf in einem Clip von 5 bis 30 Sekunden und liefert pro Kopf ein Vorschaubild in fester Reihenfolge. Im zweiten übergeben Sie die ausgewählten Positionen und je ein bis drei Referenzfotos und erhalten den Clip zurück, in dem genau diese Köpfe ersetzt sind und die Originaltonspur erhalten bleibt.

Head-Swap-Videoanalyse → Head-Swap-Videobearbeitung

Sie entscheiden, wer sich ändert

Die meisten Endpunkte dieser Art müssen raten, wen Sie gemeint haben. Hier zeigt Ihnen der erste Aufruf jeden gefundenen Kopf mit einer Nummer, und der zweite rührt ausschließlich die zurückgegebenen Nummern an. In einem Clip mit vier Personen ändern Sie eine davon, die anderen drei bleiben exakt so, wie sie gedreht wurden.

Video und Auflösung identisch halten

Video Head Swap ist kein einzelner Endpunkt, sondern ein Paar. Der erste Aufruf, video-analyze, verfolgt alle Köpfe in einem Clip von 5 bis 30 Sekunden und gibt pro Kopf ein Vorschaubild in fester Reihenfolge zurück; abgerechnet wird pauschal pro Anfrage, unabhängig von der Cliplänge und von der Zahl der gefundenen Köpfe. Der zweite Aufruf, video-edit, nimmt die Task-ID dieser Analyse, die von Ihnen gewählten Positionen und je ein bis drei Referenzfotos entgegen und liefert einen Clip mit unveränderter Originaltonspur, abgerechnet pro Sekunde Material in 480p oder 720p. Die Tracking-Daten selbst bekommen Sie nie zu sehen: Sie arbeiten mit Ihrer eigenen Task-ID und mit nullbasierten Positionen, die genau den gezeigten Vorschaubildern entsprechen. Beide Aufrufe müssen dasselbe Video und dieselbe Auflösung verwenden; eine Abweichung wird nicht stillschweigend durchgelassen, sondern führt zur Ablehnung des zweiten Aufrufs.

Eine bereits sitzende Einstellung neu besetzen

Die Einstellung mit dem abgenommenen Licht, der abgenommenen Anordnung und der abgenommenen Kamerafahrt bleibt, und statt den ganzen Shot neu zu erzeugen und die Darstellung zu verlieren, tauschen Sie nur den Kopf.

Jedes Motiv, mit einer einwilligenden Person

An der Anfrage ändert sich nichts, ganz gleich, was das Material zeigt. An der Rechtebedingung in den Grenzen weiter unten ebenso wenig: Sie ist eine harte Voraussetzung und keine Formalie.

Eine Person durch eine erzeugte Serie hindurch

Erzeugen Sie mit einem beliebigen Videomodell eine Reihe von Clips, analysieren Sie jeden einzeln und ziehen Sie denselben freigegebenen Kopf durch alle hindurch, damit die Serie als eine Person gelesen wird.

Menschenmengen, in denen sich nur einer ändert

Analysieren Sie eine Szene mit mehreren Personen, sehen Sie sich die Vorschaubilder an und senden Sie nur die gemeinte Position zurück. Alle anderen bleiben unangetastet.

# 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/head-swap-video-v1/video-edit",
  "input": {
    "analysis_task_id": "example",
    "resolution": "720p",
    "swap_targets": [
      {
        "image_urls": [
          "example"
        ],
        "object_index": 0
      }
    ]
  }
}'

# 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.