Sanggunian ng production API

DeepSwapAI: AI Face Swap API

Ikonekta ang photo, photo batch, mapped group-photo, video, at GIF face swap sa iisang production interface. Suriin dito ang kontrata, mga billing unit, mga estado ng task, at mga hangganan; buksan ang kumpletong English API reference para sa bawat field at response.

DeepSwapAI Product Team2026-08-27API documentation

HTTPS, multipart upload, at mga estado ng task sa JSON

Bawat nakalathalang generation route ay gumagamit ng Bearer API key, nagbabalik ng taskId, at ipinapakita ang status ng task sa pamamagitan ng GET sa parehong route.

AuthenticationBearer API keyIpinapakita lamang ang key kapag ito ay ginawa; ang SHA-256 hash lamang nito ang iniimbak ng server.
PagkumpletoMag-poll gamit ang taskIdAng mga terminal state ay COMPLETED, FAILED, o CANCELLED.
PagsingilIsang-beses na credits ng accountHindi lumilikha ng panibagong singil sa generation ang pag-poll gamit ang GET.
Mga asset para sa developerOpenAPI 3.1 + PostmanWala pang nakalathalang opisyal na language SDK o webhook callback sa kasalukuyan.

Saklaw ng isang API account ang limang uri ng input para sa face swap

Ang mga photo, photo batch, mapped na mukha sa group photo, video, at GIF ay gumagamit ng parehong production domain at lifecycle ng task. Bago ang bawat request, i-validate ang format, laki, tagal, bilang ng target, at available na credits; pagkatapos mag-submit, i-save ang taskId at i-poll ang katugmang GET route.

Mga route, billing unit, at pangunahing hangganan

WorkflowPOST routeKasalukuyang unitPangunahing hangganan
LarawanPOST /api/ai-tasks6 credits bawat outputIsang source na mukha at isang target na larawan
Batch ng larawanPOST /api/ai-tasks/batch-face-swap6 credits bawat outputHanggang 20 input image sa kabuuan; 95 MB sa kabuuan
Pagma-map sa grupong larawanPOST /api/ai-tasks/multi-face-swap6 credits bawat napiling mukhaHanggang 10 naka-map na mukha; 95 MB sa kabuuan
VideoPOST /api/ai-tasks/video3 credits bawat segundong ni-round up; minimum na 12MP4, MOV, o WebM; 600 segundo (95 MB bawat API request, mga 1–1.5 min ng karaniwang 1080p na video mula sa phone); nakapirming pinakamataas na 1080p tier
GIFPOST /api/ai-tasks/gif3 credits bawat segundong ni-round up; minimum na 12GIF, MP4, o WebM; 30 segundo

I-validate ang request bago mag-submit ng generation task

  1. 1. Itago ang mga API key sa iyong server, huwag kailanman sa browser, mobile package, log, o pampublikong repository.
  2. 2. I-validate ang mga multipart field, uri ng file, laki, bilang, tagal, at credits para sa napiling workflow.
  3. 3. I-submit ang POST request at i-save nang permanente ang ibinalik na taskId kasama ang inaasahang singil.
  4. 4. I-poll ang GET sa parehong route hanggang umabot ang task sa COMPLETED, FAILED, o CANCELLED.
  5. 5. Ihatid lamang ang mga resulta sa account na may-ari ng task at alisin ang media ayon sa nakalathalang patakaran sa retention.

Walang idempotency-key field na naidokumento sa pampublikong kontrata. Dapat i-disable ng tumatawag na serbisyo ang duplicate submission, panatilihin ang unang taskId, at magkasundo sa hindi tiyak na network response bago mag-isyu ng isa pang POST.

Panatilihin ang taskId at huminto sa isang terminal state

EventTala ng gawainAksyon sa creditsAksyon ng kliyente
Tinanggap ang taskI-persist ang taskId at expected costIturing ang settlement bilang server-ownedSimulan ang sinusukat na polling
Natapos ang taskPanghuling resultaAng natapos na trabaho ay nananatiling naayosPahintulutan ang pagkuha ng resulta
Nabigo ang pagprosesoPanghuling pagkabigoAng kasalukuyang refund ng kontrata ay awtomatikong nabigo sa pagprosesoBasahin ang pagkabigo bago magpasyang muling isumite
Hindi tiyak ang resulta ng responseMagkasundo bago ang isa pang POSTHuwag manghula batay sa timeoutGamitin ang naka-imbak na taskId o kasaysayan ng account

Hindi tiyak ang resulta ng response Walang idempotency-key field na naidokumento sa pampublikong kontrata. Dapat i-disable ng tumatawag na serbisyo ang duplicate submission, panatilihin ang unang taskId, at magkasundo sa hindi tiyak na network response bago mag-isyu ng isa pang POST.

Bumuo ng mga nabe-verify na hangganan sa iyong integration

Kailangan sa API access ang na-verify na email at kahit isang credit order na may status na PAID o COMPLETED. Bawat account ay makakagawa ng hanggang 3 API key, na may hanggang 6 na generation request bawat minuto sa bawat key. Ibinabalik ang credits ng mga nabigong task ayon sa kasalukuyang patakaran, at binubura ang media sa loob ng 24 na oras.

Buksan ang kumpletong English API reference: Buksan ang kumpletong English API reference. Nasa Patakaran sa Privacy at Presyo ang mga patakarang partikular sa produkto.

Kumpirmahin ang mga puntong ito bago mag-launch

Sinusuportahan ba ng API ang mga webhook?

Hindi sa kasalukuyan. Itago ang taskId na ibinalik ng POST at i-poll ang GET sa parehong workflow route hanggang umabot sa terminal state.

May opisyal bang SDK?

Wala pang nakalathalang opisyal na language SDK sa kasalukuyan. Gumagana ang karaniwang HTTPS, Bearer authentication, multipart data, at mga JSON response sa anumang server-side HTTP client.

Ilang credits ang ginagamit ng isang photo task?

Ang isang photo, isang batch output, o isang napiling mukha sa group photo ay kasalukuyang gumagamit ng 6 credits. Ang video at GIF ay gumagamit ng seconds na ni-round up at may minimum na singil.

Puwede ko bang ilagay ang API key sa frontend code?

Hindi. Iimbak ang mga API key sa server at huwag kailanman isulat ang mga ito sa browser bundle, mobile binary, log, analytics event, o support ticket.

I-validate ang integration gamit ang isang kinatawang task

Subukan ang mga field, estado, singil, at paghahatid ng resulta gamit ang pinakamaliit na awtorisadong media sample bago mag-scale sa mga batch o mahahabang video.

Buksan ang kumpletong API documentation