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
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
Medien hochladen
Fordere eine vorsignierte Upload-URL an und lade dann dein Quellgesicht sowie das Zielbild oder -video per PUT hoch.
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_KEYEndpunkte
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.jpgPOST /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 vergleichenFehlercodes
| HTTP | Code | Bedeutung |
|---|---|---|
| 401 | INVALID_API_KEY | Der API-Schlüssel fehlt, ist ungültig, deaktiviert oder abgelaufen. |
| 403 | API_REQUIRES_SUBSCRIPTION | Das Konto hat kein aktives Abo. Abonniere einen Plan, um die API zu nutzen. |
| 402 | INSUFFICIENT_CREDITS | Das Konto hat zu wenige Credits für diesen Job. Führe ein Plan-Upgrade durch oder kaufe ein Credit-Paket. |
| 400 | VIDEO_TOO_LONG | Das Video überschreitet das Längenlimit für die gewählten Optionen. |
| 429 | RATE_LIMITED | Zu 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