Productie-API-referentie
DeepSwapAI: AI-face-swap-API
Koppel gezichtswissel voor foto's, fotobatches, groepsfoto's met gezichtstoewijzing, video's en GIF via één productie-interface. Bekijk hier het contract, de factureringseenheden, de taakstatussen en de grenzen; open de volledige Engelstalige API-referentie voor elk veld en elke respons.
Eén contract, vijf workflows
HTTPS, multipart-uploads en JSON-taakstatussen
Elke gepubliceerde generatieroute gebruikt een Bearer API-sleutel, retourneert een taskId en maakt de taakstatus beschikbaar via GET op diezelfde route.
Direct antwoord
Eén API-account dekt vijf invoertypen voor gezichtswissel
Foto's, fotobatches, toegewezen gezichten in groepsfoto's, video's en GIF gebruiken hetzelfde productiedomein en dezelfde taaklevenscyclus. Valideer vóór elk verzoek het formaat, de grootte, de duur, het aantal doelen en de beschikbare kredieten; sla na het indienen de taskId op en poll de bijbehorende GET-route.
Huidig openbaar contract
Routes, factureringseenheden en belangrijkste grenzen
| Workflow | POST-route | Huidige eenheid | Belangrijkste grens |
|---|---|---|---|
| Foto | POST /api/ai-tasks | 6 credits / uitvoer | One source face and one target image |
| Fotobatch | POST /api/ai-tasks/batch-face-swap | 6 credits / uitvoer | Maximaal 20 invoerbeelden in totaal; 95 MB totaal |
| Groepstoewijzing | POST /api/ai-tasks/multi-face-swap | 6 credits / selected face | Up to 10 mapped faces; 95 MB combined |
| Video | POST /api/ai-tasks/video | 3 credits / rounded second; 12 minimum | MP4, MOV, or WebM; 600 seconds; fixed highest 1080p tier |
| GIF | POST /api/ai-tasks/gif | 3 credits / rounded second; 12 minimum | GIF, MP4, or WebM; 30 seconds |
Minimale integratiestroom
Valideer het verzoek voordat u een generatietaak indient
- 1. Bewaar API-sleutels op uw server, nooit in een browser, mobiel pakket, logbestand of openbare repository.
- 2. Valideer de multipart-velden, bestandstypen, groottes, aantallen, duur en kredieten voor de gekozen workflow.
- 3. Dien het POST-verzoek in en sla de geretourneerde taskId op samen met de verwachte kosten.
- 4. Poll GET op dezelfde route totdat de taak COMPLETED, FAILED of CANCELLED bereikt.
- 5. Lever resultaten alleen aan het account dat eigenaar is van de taak en verwijder media volgens de gepubliceerde bewaarregel.
Er is geen idempotentie-sleutelveld gedocumenteerd in het publieke contract. De aanroepende service moet dubbele verzending uitschakelen, de eerste taskId bewaren en een onzekere netwerkrespons afstemmen voordat een nieuwe POST wordt gedaan.
Taaklevenscyclus
Houd de taskId vast en stop bij een eindstatus
| Gebeurtenis | Taakrecord | Creditactie | Clientactie |
|---|---|---|---|
| Taak geaccepteerd | Bewaar taskId en verwachte kosten | Behandel vereffening als server-eigendom | Begin gemeten polling |
| Taak voltooid | Eindresultaat | Voltooid werk blijft vereffend | Autoriseer resultaat ophalen |
| Verwerking mislukt | Eindfalen | Huidig contract refunds mislukte verwerking automatisch | Lees de fout voordat u besluit opnieuw in te dienen |
| Reactie-uitkomst onzeker | Afstemmen voor een volgende POST | Nooit raden na een time-out | Gebruik de opgeslagen taskId of accountgeschiedenis |
Reactie-uitkomst onzeker Er is geen idempotentie-sleutelveld gedocumenteerd in het publieke contract. De aanroepende service moet dubbele verzending uitschakelen, de eerste taskId bewaren en een onzekere netwerkrespons afstemmen voordat een nieuwe POST wordt gedaan.
Facturering, privacy en export
Bouw verifieerbare grenzen in uw integratie in
API access requires a verified email and at least one PAID or COMPLETED credit order. Reward and trial credits are limited to the signed-in web workflow and cannot be automated through the API. Each account can create up to 3 API keys, with up to 6 generation requests per minute per key. Failed tasks are refunded under the current rules, and media is deleted within 24 hours.
Vragen van ontwikkelaars
Controleer deze punten vóór de lancering
Ondersteunt de API webhooks?
Momenteel niet. Bewaar de taskId die POST retourneert en poll GET op dezelfde workflowroute tot een eindstatus is bereikt.
Is er een officiële SDK?
Er is momenteel geen officiële taal-SDK gepubliceerd. Standaard HTTPS, Bearer-authenticatie, multipart-gegevens en JSON-responsen werken met elke server-side HTTP-client.
Hoeveel kredieten gebruikt één fototaak?
Eén foto, één batchuitvoer of één geselecteerd gezicht in een groepsfoto kost momenteel 6 kredieten. Voor video en GIF gelden naar boven afgeronde seconden en minimale kosten.
Kan ik een API-sleutel in frontendcode plaatsen?
Nee. Bewaar API-sleutels op de server en zet ze nooit in browserbundels, mobiele binaries, logbestanden, analytics-events of supporttickets.
Valideer de integratie met één representatieve taak
Test velden, statussen, kosten en de levering van resultaten met het kleinste geautoriseerde mediavoorbeeld voordat u opschaalt naar batches of lange video's.