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.
Isang kontrata, limang workflow
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.
Direktang sagot
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.
Kasalukuyang pampublikong kontrata
Mga route, billing unit, at pangunahing hangganan
| Workflow | POST route | Kasalukuyang unit | Pangunahing hangganan |
|---|---|---|---|
| Larawan | POST /api/ai-tasks | 6 credits bawat output | Isang source na mukha at isang target na larawan |
| Batch ng larawan | POST /api/ai-tasks/batch-face-swap | 6 credits bawat output | Hanggang 20 input image sa kabuuan; 95 MB sa kabuuan |
| Pagma-map sa grupong larawan | POST /api/ai-tasks/multi-face-swap | 6 credits bawat napiling mukha | Hanggang 10 naka-map na mukha; 95 MB sa kabuuan |
| Video | POST /api/ai-tasks/video | 3 credits bawat segundong ni-round up; minimum na 12 | MP4, 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 |
| GIF | POST /api/ai-tasks/gif | 3 credits bawat segundong ni-round up; minimum na 12 | GIF, MP4, o WebM; 30 segundo |
Minimum na integration flow
I-validate ang request bago mag-submit ng generation task
- 1. Itago ang mga API key sa iyong server, huwag kailanman sa browser, mobile package, log, o pampublikong repository.
- 2. I-validate ang mga multipart field, uri ng file, laki, bilang, tagal, at credits para sa napiling workflow.
- 3. I-submit ang POST request at i-save nang permanente ang ibinalik na taskId kasama ang inaasahang singil.
- 4. I-poll ang GET sa parehong route hanggang umabot ang task sa COMPLETED, FAILED, o CANCELLED.
- 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.
Ikot ng buhay ng gawain
Panatilihin ang taskId at huminto sa isang terminal state
| Event | Tala ng gawain | Aksyon sa credits | Aksyon ng kliyente |
|---|---|---|---|
| Tinanggap ang task | I-persist ang taskId at expected cost | Ituring ang settlement bilang server-owned | Simulan ang sinusukat na polling |
| Natapos ang task | Panghuling resulta | Ang natapos na trabaho ay nananatiling naayos | Pahintulutan ang pagkuha ng resulta |
| Nabigo ang pagproseso | Panghuling pagkabigo | Ang kasalukuyang refund ng kontrata ay awtomatikong nabigo sa pagproseso | Basahin ang pagkabigo bago magpasyang muling isumite |
| Hindi tiyak ang resulta ng response | Magkasundo bago ang isa pang POST | Huwag manghula batay sa timeout | Gamitin 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.
Pagsingil, pribasya, at export
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.
Mga tanong ng developer
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.
