Produktions-API-Referenz
DeepSwapAI AI Face Swap API
Verbinden Sie Foto-, Foto-Batch-, Gruppenfoto-Mapping-, Video- und GIF-Face-Swap über eine einheitliche Produktionsschnittstelle. Prüfen Sie Vertrag, Kosteneinheiten, Aufgabenstatus und Grenzen; vollständige Felder und Antworten stehen in der englischen API-Referenz.
Ein Vertrag, fünf Workflows
HTTPS, multipart-Uploads und JSON-Aufgabenstatus
Alle veröffentlichten Generierungsrouten verwenden einen Bearer-API-Key, liefern eine taskId und prüfen den Status per GET auf derselben Route.
Direkte Antwort
Ein API-Konto für fünf Eingabe-Workflows
Fotos, Foto-Batches, Mapping mehrerer Gesichter im Gruppenfoto, Videos und GIFs verwenden dieselbe Produktionsdomain und denselben Aufgabenzyklus. Prüfen Sie vor dem Request Format, Größe, Dauer, Zielanzahl und Credits; speichern Sie danach die taskId und pollen Sie die passende GET-Route.
Aktueller öffentlicher Vertrag
Routen, Kosteneinheiten und Hauptgrenzen
| Workflow | POST-Route | Einheit | Hauptgrenze |
|---|---|---|---|
| Foto | POST /api/ai-tasks | 3 Credits / Ausgabe | Ein Quellgesicht und ein Zielbild |
| Foto-Batch | POST /api/ai-tasks/batch-face-swap | 3 Credits / Ausgabe | Bis zu 20 Bilder; zusammen 95 MB |
| Gruppen-Mapping | POST /api/ai-tasks/multi-face-swap | 3 Credits / ausgewähltes Gesicht | Bis zu 10 zugeordnete Gesichter; zusammen 95 MB |
| Video | POST /api/ai-tasks/video | 2 Credits je aufgerundeter Sekunde; mindestens 6 | MP4, MOV oder WebM; 300 Sekunden; 720p oder 1080p |
| GIF | POST /api/ai-tasks/gif | 3 Credits je aufgerundeter Sekunde; mindestens 6 | GIF, MP4 oder WebM; 30 Sekunden |
Minimale Integration
Request prüfen, dann die Generierung senden
- 1. Bewahren Sie den API-Key serverseitig auf, nicht im Browser, Mobile-Bundle, Log oder öffentlichen Repository.
- 2. Prüfen Sie multipart-Felder, Dateiformate, Größe, Anzahl, Dauer und Credits pro Workflow.
- 3. Senden Sie POST und speichern Sie taskId sowie die erwartete Belastung.
- 4. Pollen Sie den GET-Endpunkt derselben Route bis COMPLETED, FAILED oder CANCELLED.
- 5. Liefern Sie das Ergebnis nur an das Eigentümerkonto und löschen Sie Medien gemäß der veröffentlichten Aufbewahrungsregel.
Kosten, Datenschutz und Export
Nachweisbare Grenzen in die Integration einbauen
Die API verwendet dasselbe einmalige Credit-Guthaben wie die Web-App. Fehlgeschlagene Generierungsaufgaben werden nach der aktuellen Produktregel automatisch erstattet. Vor dem ersten abgeschlossenen Kauf enthalten Testbild-Exporte DeepSwapAI.com und die vollständige Konto-E-Mail; der Kauf wirkt nur auf künftig erzeugte Bilder. Uploads und erzeugte Medien werden binnen 24 Stunden vom Server gelöscht und nicht zum Training von KI-Modellen verwendet.
Fragen für Entwickler
Vor dem Launch prüfen
Unterstützt die API Webhooks?
Noch nicht. Speichern Sie nach POST die taskId und pollen Sie GET auf derselben Workflow-Route bis zum Endstatus.
Gibt es ein offizielles SDK?
Aktuell sind keine offiziellen Sprach-SDKs veröffentlicht. Standard-HTTPS, Bearer, multipart und JSON funktionieren mit jedem serverseitigen HTTP-Client.
Wie viele Credits kostet ein Foto?
Ein Foto, ein Batch-Ergebnis oder ein ausgewähltes Gesicht im Gruppenfoto kostet aktuell jeweils 3 Credits. Video und GIF werden über aufgerundete Sekunden und Mindestkosten berechnet.
Darf der API-Key ins Frontend?
Nein. Halten Sie ihn serverseitig und schreiben Sie ihn nicht in Browser-Bundles, mobile Binärdateien, Logs, Analytics-Events oder Support-Tickets.
Integration mit einer repräsentativen Aufgabe prüfen
Testen Sie Felder, Status, Abrechnung und Zustellung zunächst mit erlaubten Minimalmedien, bevor Sie auf Batches oder lange Videos skalieren.