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 | 6 créditos / resultado | Una cara de origen y una imagen objetivo |
| Lote de fotos | POST /api/ai-tasks/batch-face-swap | 6 créditos / resultado | Hasta 20 imágenes de entrada en total; 95 MB en total |
| Mapeo grupal | POST /api/ai-tasks/multi-face-swap | 6 créditos / rostro seleccionado | Hasta 10 rostros mapeados; 95 MB en total |
| Vídeo | POST /api/ai-tasks/video | 3 créditos por segundo redondeado; mínimo 12 | MP4, MOV o WebM; 600 segundos (95 MB por solicitud a la API, unos 1–1,5 min de vídeo 1080p típico de móvil); nivel máximo 1080p fijo |
| GIF | POST /api/ai-tasks/gif | 3 créditos por segundo redondeado; mínimo 12 | 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.
No se documenta un campo idempotency-key en el contrato público. El servicio llamante debe deshabilitar el envío duplicado, persistir el primer taskId y conciliar una respuesta de red incierta antes de emitir otro POST.
Ciclo de vida de la tarea
Conserve el taskId y deténgase en un estado terminal
| Evento | Registro de la tarea | Acción sobre los créditos | Acción del cliente |
|---|---|---|---|
| Tarea aceptada | Persistir taskId y costo esperado | Tratar el acuerdo como propiedad del servidor | Iniciar un sondeo medido |
| Tarea completada | Resultado final | El trabajo completado permanece acordado | Autorizar la descarga del resultado |
| Error de procesamiento | Fallo definitivo | El contrato actual reembolsa automáticamente el procesamiento fallido | Lee el fallo antes de decidir reenviar |
| Resultado de la respuesta incierto | Concilia antes de otro POST | Nunca hagas suposiciones a partir de un tiempo de espera agotado | Usa el taskId almacenado o el historial de la cuenta |
Resultado de la respuesta incierto No se documenta un campo idempotency-key en el contrato público. El servicio llamante debe deshabilitar el envío duplicado, persistir el primer taskId y conciliar una respuesta de red incierta antes de emitir otro POST.
Coste, privacidad y exportación
Incluye límites verificables en tu integración
El acceso API requiere correo verificado y al menos un pedido de créditos PAID o COMPLETED. Máximo 3 claves por cuenta y 6 solicitudes de generación por minuto y clave. Las tareas fallidas se reembolsan y los medios se eliminan en 24 horas.
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 6 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.