API-referens för produktion

DeepSwapAI: API för AI-ansiktsbyte

Anslut ansiktsbyte för foto, fotobatch, mappade gruppfoton, video och GIF via ett och samma produktionsgränssnitt. Granska kontraktet, debiteringsenheterna, uppgiftsstatusarna och gränserna här; öppna den fullständiga engelska API-referensen för alla fält och svar.

DeepSwapAI Product Team2026-08-27API-dokumentation

HTTPS, multipart-uppladdningar och uppgiftsstatus i JSON

Varje publicerad genereringsroute använder en Bearer-API-nyckel, returnerar ett taskId och visar uppgiftsstatus via GET på samma route.

AutentiseringBearer-API-nyckelEn nyckel visas endast när den skapas; servern lagrar bara dess SHA-256-hash.
SlutförandePolla via taskIdSlutstatusarna är COMPLETED, FAILED eller CANCELLED.
DebiteringEngångskrediter på kontotPolling med GET skapar ingen ytterligare genereringsdebitering.
UtvecklarresurserOpenAPI 3.1 + PostmanInget officiellt språk-SDK eller webhook-callback är publicerat för närvarande.

Ett API-konto täcker fem indatatyper för ansiktsbyte

Foton, fotobatcher, mappade ansikten i gruppfoton, videor och GIF använder samma produktionsdomän och uppgiftslivscykel. Validera format, storlek, längd, antal mål och tillgängliga krediter före varje förfrågan; spara taskId efter inskickningen och polla motsvarande GET-route.

Routes, debiteringsenheter och huvudsakliga gränser

ArbetsflödePOST-routeAktuell enhetHuvudsaklig gräns
FotoPOST /api/ai-tasks6 krediter / utdataEtt källansikte och en målbild
FotobatchPOST /api/ai-tasks/batch-face-swap6 krediter / utdataHögst 20 indatabilder totalt; totalt 95 MB
GruppmappningPOST /api/ai-tasks/multi-face-swap6 krediter / valt ansikteHögst 10 mappade ansikten; totalt 95 MB
VideoPOST /api/ai-tasks/video3 krediter / avrundad sekund; minst 12MP4, MOV eller WebM; 600 sekunder (95 MB per API-anrop, ungefär 1–1,5 min vanlig 1080p-mobilvideo); fast högsta 1080p-nivå
GIFPOST /api/ai-tasks/gif3 krediter / avrundad sekund; minst 12GIF, MP4 eller WebM; 30 sekunder

Validera förfrågan innan du skickar en genereringsuppgift

  1. 1. Förvara API-nycklar på din server, aldrig i en webbläsare, ett mobilpaket, en logg eller ett offentligt repository.
  2. 2. Validera multipart-fälten, filtyperna, storlekarna, antalen, längden och krediterna för det valda arbetsflödet.
  3. 3. Skicka POST-förfrågan och spara det returnerade taskId tillsammans med den förväntade debiteringen.
  4. 4. Polla GET på samma route tills uppgiften når COMPLETED, FAILED eller CANCELLED.
  5. 5. Leverera resultat endast till det konto som äger uppgiften och ta bort media enligt den publicerade lagringsregeln.

Inget idempotency-key-fält är dokumenterat i det offentliga kontraktet. Den anropande tjänsten bör inaktivera dubblettinlämning, spara det första taskId och stämma av ett osäkert nätverkssvar innan en annan POST utfärdas.

Behåll taskId och stanna vid ett terminaltillstånd

HändelseUppgiftspostKreditåtgärdKlientåtgärd
Uppgift accepteradSpara taskId och förväntad kostnadBehandla avräkning som serverägdPåbörja mätt polling
Uppgift slutfördTerminalresultatSlutfört arbete förblir avräknatAuktorisera resultathämtning
Bearbetningen misslyckadesTerminalfelNuvarande kontrakt återbetalar misslyckad bearbetning automatisktLäs felet innan du beslutar att skicka igen
Svarssultat osäkertStäm av före en annan POSTGissa aldrig från en timeoutAnvänd lagrad taskId eller kontohistorik

Svarssultat osäkert Inget idempotency-key-fält är dokumenterat i det offentliga kontraktet. Den anropande tjänsten bör inaktivera dubblettinlämning, spara det första taskId och stämma av ett osäkert nätverkssvar innan en annan POST utfärdas.

Bygg in verifierbara gränser i din integration

API-åtkomst kräver en verifierad e-postadress och minst en kreditbeställning med status PAID eller COMPLETED. Varje konto kan skapa upp till 3 API-nycklar, med högst 6 genereringsförfrågningar per minut och nyckel. Misslyckade uppgifter återbetalas enligt gällande regler och media raderas inom 24 timmar.

Öppna den fullständiga engelska API-referensen: Öppna den fullständiga engelska API-referensen. Integritetspolicy och Priser beskriver de produktspecifika villkoren.

Bekräfta dessa punkter före lansering

Stöder API:et webhooks?

Inte för närvarande. Spara det taskId som returneras av POST och polla GET på samma arbetsflödesroute tills en slutstatus nås.

Finns det ett officiellt SDK?

Inget officiellt språk-SDK är publicerat för närvarande. Standard-HTTPS, Bearer-autentisering, multipart-data och JSON-svar fungerar med alla HTTP-klienter på serversidan.

Hur många krediter använder en fotouppgift?

Ett foto, en batchutdata eller ett valt ansikte i ett gruppfoto använder för närvarande 6 krediter. Video och GIF använder sekunder avrundade uppåt och en minimidebitering.

Kan jag lägga en API-nyckel i frontendkod?

Nej. Förvara API-nycklar på servern och skriv aldrig in dem i webbläsarpaket, mobila binärfiler, loggar, analyshändelser eller supportärenden.

Validera integrationen med en representativ uppgift

Testa fält, statusar, debiteringar och resultatleverans med det minsta auktoriserade medieexemplet innan du skalar upp till batcher eller långa videor.

Öppna den fullständiga API-dokumentationen