Referência da API de produção
DeepSwapAI: API de face swap com IA
Conecte a troca de rosto em foto, lote de fotos, foto de grupo com mapeamento, vídeo e GIF por meio de uma única interface de produção. Revise aqui o contrato, as unidades de cobrança, os estados de tarefa e os limites; abra a referência completa da API em inglês para ver todos os campos e respostas.
Um contrato, cinco fluxos de trabalho
HTTPS, uploads multipart e estados de tarefa em JSON
Toda rota de geração publicada usa uma chave de API Bearer, retorna um taskId e expõe o status da tarefa via GET nessa mesma rota.
Resposta direta
Uma conta de API cobre cinco tipos de entrada de troca de rosto
Fotos, lotes de fotos, rostos mapeados em fotos de grupo, vídeos e GIFs usam o mesmo domínio de produção e o mesmo ciclo de vida de tarefa. Antes de cada requisição, valide formato, tamanho, duração, quantidade de alvos e créditos disponíveis; após o envio, salve o taskId e consulte a rota GET correspondente.
Contrato público atual
Rotas, unidades de cobrança e limites principais
| Fluxo de trabalho | Rota POST | Unidade atual | Limite principal |
|---|---|---|---|
| Foto | POST /api/ai-tasks | 6 créditos / saída | One source face and one target image |
| 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 credits / selected face | Up to 10 mapped faces; 95 MB combined |
| Vídeo | 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 |
Fluxo mínimo de integração
Valide a requisição antes de enviar uma tarefa de geração
- 1. Mantenha as chaves de API no seu servidor, nunca em um navegador, pacote mobile, log ou repositório público.
- 2. Valide os campos multipart, os tipos de arquivo, os tamanhos, as quantidades, a duração e os créditos do fluxo de trabalho selecionado.
- 3. Envie a requisição POST e armazene o taskId retornado junto com a cobrança esperada.
- 4. Consulte via GET a mesma rota até que a tarefa chegue a COMPLETED, FAILED ou CANCELLED.
- 5. Entregue os resultados somente à conta proprietária da tarefa e remova as mídias de acordo com a regra de retenção publicada.
Nenhum campo idempotency-key está documentado no contrato público. O serviço de chamada deve desabilitar submissão duplicada, persistir o primeiro taskId e reconciliar uma resposta de rede incerta antes de emitir outro POST.
Ciclo de vida da tarefa
Mantenha o taskId e pare em um estado terminal
| Evento | Registro de tarefa | Ação de crédito | Ação do cliente |
|---|---|---|---|
| Tarefa aceita | Persista taskId e custo esperado | Trate a liquidação como de propriedade do servidor | Inicie polling medido |
| Tarefa concluída | Resultado terminal | Trabalho concluído permanece liquidado | Autorize recuperação do resultado |
| Falha no processamento | Falha terminal | Contrato atual reembolsa processamento com falha automaticamente | Leia a falha antes de decidir reenviar |
| Resultado da resposta incerto | Reconcilie antes de outro POST | Nunca adivinhe a partir de um timeout | Use o taskId armazenado ou o histórico da conta |
Resultado da resposta incerto Nenhum campo idempotency-key está documentado no contrato público. O serviço de chamada deve desabilitar submissão duplicada, persistir o primeiro taskId e reconciliar uma resposta de rede incerta antes de emitir outro POST.
Cobrança, privacidade e exportação
Incorpore limites verificáveis à sua integração
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.
Perguntas de desenvolvedores
Confirme estes pontos antes do lançamento
A API oferece suporte a webhooks?
No momento, não. Guarde o taskId retornado pelo POST e consulte via GET a mesma rota do fluxo de trabalho até atingir um estado final.
Existe um SDK oficial?
No momento, nenhum SDK oficial de linguagem está publicado. HTTPS padrão, autenticação Bearer, dados multipart e respostas JSON funcionam com qualquer cliente HTTP do lado do servidor.
Quantos créditos uma tarefa de foto usa?
Uma foto, uma saída de lote ou um rosto selecionado em uma foto de grupo usa atualmente 6 créditos. Vídeo e GIF usam segundos arredondados para cima e uma cobrança mínima.
Posso colocar uma chave de API no código frontend?
Não. Armazene as chaves de API no servidor e nunca as inclua em bundles de navegador, binários mobile, logs, eventos de análise ou tickets de suporte.
Valide a integração com uma tarefa representativa
Teste campos, estados, cobranças e entrega de resultados com a menor amostra de mídia autorizada antes de escalar para lotes ou vídeos longos.