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 | 6 Credits / Ausgabe | Ein Quellgesicht und ein Zielbild |
| Foto-Batch | POST /api/ai-tasks/batch-face-swap | 6 Credits / Ausgabe | Bis zu 20 Eingabebilder insgesamt; zusammen 95 MB |
| Gruppen-Mapping | POST /api/ai-tasks/multi-face-swap | 6 Credits / ausgewähltes Gesicht | Bis zu 10 zugeordnete Gesichter; zusammen 95 MB |
| Video | POST /api/ai-tasks/video | 3 Credits je aufgerundeter Sekunde; mindestens 12 | MP4, MOV oder WebM; 600 Sekunden; höchste 1080p-Stufe fest |
| GIF | POST /api/ai-tasks/gif | 3 Credits je aufgerundeter Sekunde; mindestens 12 | 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.
Im öffentlichen Vertrag ist kein Idempotenz-Schlüsselfeld dokumentiert. Der aufrufende Dienst sollte doppelte Übermittlungen deaktivieren, die erste taskId speichern und eine unsichere Netzwerkantwort abgleichen, bevor er einen weiteren POST ausgibt.
Aufgabenlebenszyklus
Behalten Sie die taskId und stoppen Sie bei einem Endzustand
| Ereignis | Aufgabenaufzeichnung | Gutschriftaktion | Kundenaktion |
|---|---|---|---|
| Aufgabe akzeptiert | taskId und erwartete Kosten speichern | Abrechnung als servereigen behandeln | Messbasiertes Polling beginnen |
| Aufgabe abgeschlossen | Endgültiges Ergebnis | Abgeschlossene Arbeit bleibt abgerechnet | Ergebnisabruf autorisieren |
| Verarbeitung fehlgeschlagen | Endgültiger Fehler | Aktueller Vertrag erstattet fehlgeschlagene Verarbeitung automatisch | Fehler vor Entscheidung zur erneuten Übermittlung lesen |
| Antwortausgang unsicher | Vor einem weiteren POST abgleichen | Nie aus einem Timeout raten | Gespeicherte taskId oder Kontohistorie verwenden |
Antwortausgang unsicher Im öffentlichen Vertrag ist kein Idempotenz-Schlüsselfeld dokumentiert. Der aufrufende Dienst sollte doppelte Übermittlungen deaktivieren, die erste taskId speichern und eine unsichere Netzwerkantwort abgleichen, bevor er einen weiteren POST ausgibt.
Kosten, Datenschutz und Export
Nachweisbare Grenzen in die Integration einbauen
Für den API-Zugriff sind eine bestätigte E-Mail und mindestens eine Credit-Bestellung mit Status PAID oder COMPLETED erforderlich. Prämien- und Test-Credits sind nur im angemeldeten Web-Workflow verfügbar und nicht per API automatisierbar. Maximal 3 Schlüssel pro Konto und 6 Generierungsanfragen pro Minute und Schlüssel. Fehlgeschlagene Aufgaben werden erstattet; Medien werden innerhalb von 24 Stunden gelöscht.
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 6 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.