Referência da API de produção
API de face swap com IA da DeepSwapAI
Conecte face swap de fotos, lotes, grupos, vídeos e GIFs por uma interface de produção única. Confira o contrato, unidades de custo, estados e limites; campos e respostas completos estão na referência da API em inglês.
Um contrato, cinco fluxos
HTTPS, uploads multipart e estados JSON
Todas as rotas de geração publicadas usam uma chave API Bearer, retornam um taskId e consultam o estado por GET na mesma rota.
Resposta direta
Uma conta API para cinco tipos de entrada
Fotos, lotes, mapeamento de vários rostos em uma foto de grupo, vídeo e GIF usam o mesmo domínio de produção e ciclo de tarefa. Antes do pedido, confirme formato, tamanho, duração, quantidade de alvos e créditos; depois salve o taskId e consulte a rota GET correspondente.
Contrato público atual
Rotas, unidades de custo e limites principais
| Fluxo | Rota POST | Unidade | Limite principal |
|---|---|---|---|
| Foto | POST /api/ai-tasks | 3 créditos / saída | Uma face de origem e uma imagem alvo |
| Lote de fotos | POST /api/ai-tasks/batch-face-swap | 3 créditos / saída | Até 20 imagens; 95 MB no total |
| Mapeamento de grupo | POST /api/ai-tasks/multi-face-swap | 3 créditos / rosto selecionado | Até 10 rostos mapeados; 95 MB no total |
| Vídeo | POST /api/ai-tasks/video | 2 créditos por segundo arredondado; mínimo 6 | MP4, MOV ou WebM; 300 segundos; 720p ou 1080p |
| GIF | POST /api/ai-tasks/gif | 3 créditos por segundo arredondado; mínimo 6 | GIF, MP4 ou WebM; 30 segundos |
Integração mínima
Valide o pedido antes de gerar
- 1. Mantenha a chave API no servidor, nunca no navegador, pacote móvel, logs ou repositório público.
- 2. Valide campos multipart, formatos, tamanhos, quantidades, duração e créditos do fluxo escolhido.
- 3. Envie POST e salve o taskId e a cobrança esperada.
- 4. Consulte GET na mesma rota até COMPLETED, FAILED ou CANCELLED.
- 5. Entregue o resultado apenas à conta proprietária e remova as mídias conforme a regra publicada.
Custo, privacidade e exportação
Inclua limites verificáveis na integração
A API usa o mesmo saldo de créditos de compra única do produto web. Tarefas com falha são reembolsadas automaticamente pela regra atual. Antes da primeira compra concluída, imagens de teste mostram DeepSwapAI.com e o e-mail completo da conta; a compra afeta apenas novas imagens. Mídias enviadas e geradas são removidas do servidor em 24 horas e não são usadas para treinar modelos de IA.
Perguntas de desenvolvedores
Confirme antes de publicar
A API aceita webhooks?
Ainda não. Salve o taskId após POST e consulte GET na mesma rota até o estado final.
Existe SDK oficial?
Ainda não há SDK oficial de linguagem publicado. HTTPS, Bearer, multipart e JSON podem ser chamados por qualquer cliente HTTP no servidor.
Quantos créditos custa uma foto?
Uma foto, uma saída de lote ou um rosto selecionado em uma foto de grupo custam atualmente 3 créditos. Vídeo e GIF usam segundos arredondados e valor mínimo.
Posso colocar a chave API no frontend?
Não. Mantenha a chave no servidor e não a registre em bundles do navegador, binários móveis, logs, eventos de analytics ou tickets.
Valide a integração com uma tarefa representativa
Teste campos, estados, custo e entrega com uma amostra mínima autorizada antes de escalar para lotes ou vídeos longos.