Referencia de API de producción
API de face swap con IA de DeepSwapAI
Conecta face swap de fotos, lotes, grupos, vídeo y GIF mediante una interfaz de producción común. Revisa el contrato, las unidades de coste, los estados y los límites; los campos y respuestas completos están en la referencia de API en inglés.
Un contrato, cinco flujos
HTTPS, cargas multipart y estados JSON
Todas las rutas de generación publicadas usan una clave API Bearer, devuelven un taskId y consultan el estado con GET en la misma ruta.
Respuesta directa
Una cuenta API para cinco tipos de entrada
Fotos, lotes, mapeo de varias caras en una foto grupal, vídeo y GIF usan el mismo dominio de producción y ciclo de tarea. Antes de solicitar, comprueba formato, tamaño, duración, número de objetivos y créditos; después guarda el taskId y consulta la ruta GET correspondiente.
Contrato público actual
Rutas, unidades de coste y límites principales
| Flujo | Ruta POST | Unidad | Límite principal |
|---|---|---|---|
| Foto | POST /api/ai-tasks | 3 créditos / resultado | Una cara de origen y una imagen objetivo |
| Lote de fotos | POST /api/ai-tasks/batch-face-swap | 3 créditos / resultado | Hasta 20 imágenes; 95 MB en total |
| Mapeo grupal | POST /api/ai-tasks/multi-face-swap | 3 créditos / rostro seleccionado | Hasta 10 rostros mapeados; 95 MB en total |
| Vídeo | POST /api/ai-tasks/video | 2 créditos por segundo redondeado; mínimo 6 | MP4, MOV o WebM; 300 segundos; 720p o 1080p |
| GIF | POST /api/ai-tasks/gif | 3 créditos por segundo redondeado; mínimo 6 | GIF, MP4 o WebM; 30 segundos |
Integración mínima
Valida la solicitud antes de generar
- 1. Guarda la clave API en el servidor, nunca en el navegador, paquete móvil, logs o repositorio público.
- 2. Valida campos multipart, formatos, tamaños, cantidades, duración y créditos del flujo elegido.
- 3. Envía POST y guarda el taskId y el cargo previsto.
- 4. Consulta GET en la misma ruta hasta COMPLETED, FAILED o CANCELLED.
- 5. Entrega el resultado solo a la cuenta propietaria y elimina los medios según la regla publicada.
Coste, privacidad y exportación
Incluye límites verificables en tu integración
La API usa el mismo saldo de créditos de pago único que la aplicación web. Las tareas fallidas se reembolsan automáticamente según la regla actual. Antes de la primera compra completada, las imágenes de prueba incluyen DeepSwapAI.com y el correo completo de la cuenta; la compra solo afecta a imágenes nuevas. Los medios subidos y generados se eliminan del servidor en 24 horas y no se usan para entrenar modelos de IA.
Preguntas de desarrolladores
Confirma esto antes de publicar
¿La API admite webhooks?
Todavía no. Guarda el taskId después de POST y consulta GET en la misma ruta hasta el estado final.
¿Hay un SDK oficial?
No se ha publicado un SDK oficial de lenguaje. HTTPS, Bearer, multipart y JSON funcionan con cualquier cliente HTTP del servidor.
¿Cuántos créditos cuesta una foto?
Una foto, un resultado de lote o una cara seleccionada en una foto grupal cuestan actualmente 3 créditos. Vídeo y GIF se calculan por segundos redondeados y mínimo.
¿Puedo poner la clave API en el frontend?
No. Guárdala en el servidor y no la escribas en bundles del navegador, binarios móviles, logs, eventos de analítica o tickets.
Valida la integración con una tarea representativa
Prueba campos, estados, coste y entrega con medios mínimos autorizados antes de escalar a lotes o vídeos largos.