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 / output | One source face and one target image |
| Photo batch | POST /api/ai-tasks/batch-face-swap | 6 credits / output | Hanggang 20 input image sa kabuuan; 95 MB sa kabuuan |
| Group mapping | 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 |
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 | Credit action | Aksyon ng kliyente |
|---|---|---|---|
| Task accepted | I-persist ang taskId at expected cost | Ituring ang settlement bilang server-owned | Begin measured polling |
| Task completed | Terminal result | Ang natapos na trabaho ay nananatiling naayos | Authorize result retrieval |
| Nabigo ang pagproseso | Terminal failure | Ang kasalukuyang refund ng kontrata ay awtomatikong nabigo sa pagproseso | Basahin ang pagkabigo bago magpasyang muling isumite |
| Response outcome uncertain | Magkasundo bago ang isa pang POST | Huwag manghula batay sa timeout | Gamitin ang naka-imbak na taskId o kasaysayan ng account |
Response outcome uncertain 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
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.
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.