Face-Swap-API

Bring Foto- und Video-Gesichtstausch mit einer einfachen REST-API in dein eigenes Produkt. Sende einen Job, frage das Ergebnis ab und erhalte eine gehostete Ausgabe-URL.

Der API-Zugang ist in jedem Abo-Plan enthalten. Anfragen verbrauchen dieselben Credits wie die Web-App: keine separate API-Rechnung.

So funktioniert es

  1. 1

    API-Schlüssel erstellen

    Abonniere einen beliebigen Plan und erstelle dann in deinem Dashboard unter API-Schlüssel einen Schlüssel. Der Schlüssel wird nur einmal angezeigt, bewahre ihn also sicher auf.

  2. 2

    Medien hochladen

    Fordere eine vorsignierte Upload-URL an und lade dann dein Quellgesicht sowie das Zielbild oder -video per PUT hoch.

  3. 3

    Tauschen und abfragen

    Sende den Face-Swap-Job und frage die Task dann so lange ab, bis der Status succeeded ist. Lade anschließend die Datei unter outputUrl herunter.

Authentifizierung

Sende deinen API-Schlüssel bei jeder Anfrage im x-api-key-Header. Schlüssel gehören zu deinem Konto und verbrauchen dessen Credits. Halte sie geheim und rotiere sie über das Dashboard, falls sie durchsickern.

x-api-key: adf_YOUR_API_KEY

Endpunkte

POST /api/v1/uploads

Erstelle eine vorsignierte Upload-URL für eine Quell- oder Zieldatei. Lade die Datei per PUT mit demselben Content-Type auf uploadUrl hoch und verwende dann url in der Face-Swap-Anfrage. Unterstützte Typen: JPEG, PNG, WebP, MP4, QuickTime, WebM.

curl -X POST https://aideepfake.io/api/v1/uploads \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName": "target.jpg", "contentType": "image/jpeg"}'

# → { "success": true, "data": { "uploadUrl": "...", "url": "https://...", "expiresIn": 600 } }

curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @target.jpg

POST /api/v1/face-swap

Starte einen Face-Swap-Job. Ein Bildtausch kostet 15 Credits, ein Videotausch 20 Credits, also dieselben Preise wie in der Web-App. Setze targetType auf image oder video. Optionale Felder: faceEnhance, frameEnhance, watermark und targetDurationSeconds für Videos.

curl -X POST https://aideepfake.io/api/v1/face-swap \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://.../source.jpg",
    "targetUrl": "https://.../target.jpg",
    "targetType": "image"
  }'

# → { "success": true, "data": { "taskId": "...", "creditsCost": 15 } }

Video-Limits: bis zu 300 Sekunden für einen einfachen Tausch, bis zu 90 Sekunden, wenn faceEnhance oder frameEnhance aktiv ist.

GET /api/v1/face-swap/{taskId}

Frage den Task-Status ab. Das status-Feld wechselt von processing zu succeeded oder failed. Bei Erfolg enthält outputUrl das gehostete Ergebnis. Fehlgeschlagene Jobs werden automatisch erstattet.

curl https://aideepfake.io/api/v1/face-swap/TASK_ID \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "taskId": "...", "status": "succeeded",
#      "outputUrl": "https://...", "targetType": "image" } }

GET /api/v1/credits

Lies dein aktuelles Credit-Guthaben und deinen Plan aus, bevor du Jobs sendest.

curl https://aideepfake.io/api/v1/credits \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "credits": 1000, "subscriptionCredits": 985,
#      "oneTimeCredits": 15, "planId": "...", "currentPeriodEnd": "..." } }

Preise und Kontingent

Die API hat keine separate Preisliste. Jede Anfrage verbraucht die Credits deines Abo-Plans: 15 Credits pro Bildtausch und 20 Credits pro Videotausch, genau wie in der Web-App. Dein monatliches Credit-Kontingent richtet sich nach deinem Plan.

Pläne vergleichen

Fehlercodes

HTTPCodeBedeutung
401INVALID_API_KEYDer API-Schlüssel fehlt, ist ungültig, deaktiviert oder abgelaufen.
403API_REQUIRES_SUBSCRIPTIONDas Konto hat kein aktives Abo. Abonniere einen Plan, um die API zu nutzen.
402INSUFFICIENT_CREDITSDas Konto hat zu wenige Credits für diesen Job. Führe ein Plan-Upgrade durch oder kaufe ein Credit-Paket.
400VIDEO_TOO_LONGDas Video überschreitet das Längenlimit für die gewählten Optionen.
429RATE_LIMITEDZu viele Anfragen. Reduziere das Tempo und versuche es nach einer kurzen Wartezeit erneut.

Häufig gestellte Fragen

Wer kann die Face-Swap-API nutzen?

Jedes Konto mit einem aktiven Abo-Plan. Kostenlose Konten können die Web-App nutzen, aber nicht die API.

Was kosten API-Anfragen?

Dasselbe wie in der Web-App: 15 Credits pro Bildtausch und 20 Credits pro Videotausch. Anfragen greifen auf dasselbe Credit-Guthaben zu wie deine Web-Nutzung.

Unterstützt die API Video-Gesichtstausch?

Ja. Setze targetType auf video. Einfache Videotausche akzeptieren bis zu 300 Sekunden; Tausche mit Gesichts- oder Frame-Verbesserung akzeptieren bis zu 90 Sekunden.

Wie bekomme ich das Ergebnis?

Frage GET /api/v1/face-swap/{taskId} ab, bis status auf succeeded steht. Die Antwort enthält eine outputUrl mit der gehosteten Ergebnisdatei.

Was passiert, wenn ein Job fehlschlägt?

Fehlgeschlagene Jobs werden automatisch erstattet. Die Status-Antwort enthält ein error-Feld mit dem Grund.

Was passiert, wenn mein Abo endet?

Deine API-Schlüssel funktionieren sofort nicht mehr. Sie funktionieren wieder, sobald du erneut abonnierst: Du brauchst keine neuen Schlüssel.

Leg los

Erstelle deinen API-Schlüssel und führe deinen ersten Face Swap in wenigen Minuten aus.

API-Schlüssel erstellen