Video Character Swap API

Video Character 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 Personen zurück. Die ganze Figur ändert sich, Kleidung und Statur eingeschlossen; Set, Kamerafahrt, Choreografie und Originaltonspur bleiben so, wie sie gedreht wurden. Nicht aufgeführte Personen bleiben unangetastet.

Video Character Swap läuft in zwei Aufrufen. Der erste verfolgt jede Person in einem Clip von 5 bis 30 Sekunden und liefert pro Person 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 Personen ersetzt sind und die Originaltonspur erhalten bleibt.

Character Swap-Videoanalyse → Character 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 jede gefundene Person mit einer Nummer, und der zweite rührt ausschließlich die zurückgegebenen Nummern an. In einer Szene mit vier Personen ersetzen Sie eine davon, die anderen drei bleiben exakt so, wie sie gedreht wurden.

Geben Sie dem Modell etwas unterhalb des Halses

Video Character Swap ist kein einzelner Endpunkt, sondern ein Paar. Der erste Aufruf, video-analyze, verfolgt alle Personen in einem Clip von 5 bis 30 Sekunden und gibt pro Person ein Vorschaubild in fester Reihenfolge zurück; abgerechnet wird pauschal pro Anfrage, unabhängig von der Cliplänge und von der Zahl der gefundenen Personen. 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. Während das Head-Swap-Paar nur den Kopf verändert, ersetzt dieses die ganze Figur samt Kleidung und Statur, während Set, Kamerafahrt und Choreografie so bleiben, wie sie gedreht wurden. Die Tracking-Daten selbst bekommen Sie nie zu sehen: Sie arbeiten mit Ihrer eigenen Task-ID und mit nullbasierten Positionen.

Neu besetzen, ohne neu zu drehen

Set, Kamerafahrt und Choreografie stimmen bereits. Statt den ganzen Shot neu zu erzeugen und die Bildentwicklung von vorn zu beginnen, ersetzen Sie nur die Figur, die ihn spielt.

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 Figur durch eine erzeugte Serie hindurch

Erzeugen Sie mit einem beliebigen Videomodell eine Reihe von Clips, analysieren Sie jeden einzeln und ziehen Sie dieselbe Figur durch alle hindurch, damit die Serie als eine durchgehende Darstellung 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/character-swap-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.