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 | 6 créditos / saída | Uma face de origem e uma imagem alvo |
| Lote de fotos | POST /api/ai-tasks/batch-face-swap | 6 créditos / saída | Até 20 imagens de entrada no total; 95 MB no total |
| Mapeamento de grupo | POST /api/ai-tasks/multi-face-swap | 6 créditos / rosto selecionado | Até 10 rostos mapeados; 95 MB no total |
| Vídeo | POST /api/ai-tasks/video | 3 créditos por segundo arredondado; mínimo 12 | MP4, MOV ou WebM; 600 segundos; nível máximo 1080p fixo |
| GIF | POST /api/ai-tasks/gif | 3 créditos por segundo arredondado; mínimo 12 | 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.
Nenhum campo idempotency-key está documentado no contrato público. O serviço chamador deve desativar submissão duplicada, persistir o primeiro taskId e conciliar uma resposta de rede incerta antes de emitir outro POST.
Ciclo de vida da tarefa
Mantenha o taskId e pare num estado terminal
| Evento | Registo de tarefa | Ação de crédito | Ação de cliente |
|---|---|---|---|
| Tarefa aceite | Persistir taskId e custo esperado | Tratar liquidação como propriedade do servidor | Iniciar sondagem medida |
| Tarefa concluída | Resultado terminal | Trabalho concluído permanece liquidado | Autorizar recuperação de resultado |
| Falha no processamento | Falha terminal | O contrato atual reembolsa automaticamente processamento falhado | Ler a falha antes de decidir reenviar |
| Resultado da resposta incerto | Conciliar antes de outro POST | Nunca adivinhar a partir de um timeout | Usar o taskId armazenado ou histórico da conta |
Resultado da resposta incerto Nenhum campo idempotency-key está documentado no contrato público. O serviço chamador deve desativar submissão duplicada, persistir o primeiro taskId e conciliar uma resposta de rede incerta antes de emitir outro POST.
Custo, privacidade e exportação
Inclua limites verificáveis na integração
O acesso à API exige e-mail verificado e pelo menos um pedido de créditos PAID ou COMPLETED. Créditos de recompensa e teste são exclusivos do fluxo web autenticado e não podem ser automatizados pela API. Máximo de 3 chaves por conta e 6 solicitações de geração por minuto por chave. Tarefas com falha são reembolsadas e as mídias são removidas em 24 horas.
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 6 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.