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.

DeepSwapAI Product Team2026-08-27API-documentatie

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.

AuthenticatieBearer API-sleutelEen sleutel wordt alleen getoond wanneer deze wordt aangemaakt; de server slaat alleen de SHA-256-hash ervan op.
VoltooiingPollen op taskIdEindstatussen zijn COMPLETED, FAILED of CANCELLED.
FactureringEenmalige accountkredietenPollen via GET leidt niet tot een extra afschrijving voor een generatie.
OntwikkelaarsmiddelenOpenAPI 3.1 + PostmanEr is momenteel geen officiële taal-SDK of webhook-callback gepubliceerd.

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.

Routes, factureringseenheden en belangrijkste grenzen

WorkflowPOST-routeHuidige eenheidBelangrijkste grens
FotoPOST /api/ai-tasks6 credits / uitvoerEén brongezicht en één doelafbeelding
FotobatchPOST /api/ai-tasks/batch-face-swap6 credits / uitvoerMaximaal 20 invoerbeelden in totaal; 95 MB totaal
GroepstoewijzingPOST /api/ai-tasks/multi-face-swap6 credits / geselecteerd gezichtMaximaal 10 toegewezen gezichten; 95 MB totaal
VideoPOST /api/ai-tasks/video3 credits / afgeronde seconde; minimaal 12MP4, MOV of WebM; 600 seconden (95 MB per API-verzoek, ongeveer 1–1,5 min gewone 1080p-telefoonvideo); vaste hoogste 1080p-kwaliteit
GIFPOST /api/ai-tasks/gif3 credits / afgeronde seconde; minimaal 12GIF, MP4 of WebM; 30 seconden

Valideer het verzoek voordat u een generatietaak indient

  1. 1. Bewaar API-sleutels op uw server, nooit in een browser, mobiel pakket, logbestand of openbare repository.
  2. 2. Valideer de multipart-velden, bestandstypen, groottes, aantallen, duur en kredieten voor de gekozen workflow.
  3. 3. Dien het POST-verzoek in en sla de geretourneerde taskId op samen met de verwachte kosten.
  4. 4. Poll GET op dezelfde route totdat de taak COMPLETED, FAILED of CANCELLED bereikt.
  5. 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.

Houd de taskId vast en stop bij een eindstatus

GebeurtenisTaakrecordCreditactieClientactie
Taak geaccepteerdBewaar taskId en verwachte kostenBehandel vereffening als server-eigendomBegin gemeten polling
Taak voltooidEindresultaatVoltooid werk blijft vereffendAutoriseer resultaat ophalen
Verwerking misluktEindfalenHuidig contract refunds mislukte verwerking automatischLees de fout voordat u besluit opnieuw in te dienen
Reactie-uitkomst onzekerAfstemmen voor een volgende POSTNooit raden na een time-outGebruik 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.

Bouw verifieerbare grenzen in uw integratie in

Voor API-toegang zijn een geverifieerd e-mailadres en ten minste één creditbestelling met status PAID of COMPLETED nodig. Elk account kan maximaal 3 API-sleutels aanmaken, met maximaal 6 generatieverzoeken per minuut per sleutel. Mislukte taken worden volgens de huidige regels terugbetaald en media worden binnen 24 uur verwijderd.

Open de volledige Engelstalige API-referentie: Open de volledige Engelstalige API-referentie. Privacybeleid en Prijzen beschrijven de productspecifieke voorwaarden.

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.

Open de volledige API-documentatie