API de Intercambio de Caras

Añade el intercambio de caras en fotos y vídeos a tu propio producto con una sencilla API REST. Envía un trabajo, consulta el resultado y obtén una URL de salida alojada.

El acceso a la API está incluido en todos los planes de suscripción. Las solicitudes usan los mismos créditos que la aplicación web: sin facturación aparte por la API.

Cómo funciona

  1. 1

    Crea una clave API

    Suscríbete a cualquier plan y crea una clave en tu panel, en la sección Claves API. La clave se muestra una sola vez, así que guárdala en un lugar seguro.

  2. 2

    Sube tus archivos

    Solicita una URL de subida prefirmada y luego haz un PUT de tu cara de origen y de la imagen o el vídeo de destino.

  3. 3

    Intercambia y consulta

    Envía el trabajo de intercambio de caras, consulta la tarea hasta que el estado sea succeeded y descarga la URL de salida.

Autenticación

Envía tu clave API en el encabezado x-api-key con cada solicitud. Las claves pertenecen a tu cuenta y consumen los créditos de tu cuenta. Mantenlas en secreto y rótalas desde el panel si se filtran.

x-api-key: adf_YOUR_API_KEY

Endpoints

POST /api/v1/uploads

Crea una URL de subida prefirmada para un archivo de origen o de destino. Haz un PUT del archivo a uploadUrl con el mismo Content-Type y luego usa url en la solicitud de intercambio de caras. Tipos admitidos: JPEG, PNG, WebP, MP4, QuickTime, WebM.

curl -X POST https://aideepfake.io/api/v1/uploads \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName": "target.jpg", "contentType": "image/jpeg"}'

# → { "success": true, "data": { "uploadUrl": "...", "url": "https://...", "expiresIn": 600 } }

curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @target.jpg

POST /api/v1/face-swap

Inicia un trabajo de intercambio de caras. Un intercambio de imagen cuesta 15 créditos y un intercambio de vídeo cuesta 20 créditos, los mismos precios que la aplicación web. Establece targetType en image o video. Campos opcionales: faceEnhance, frameEnhance, watermark y targetDurationSeconds para vídeos.

curl -X POST https://aideepfake.io/api/v1/face-swap \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://.../source.jpg",
    "targetUrl": "https://.../target.jpg",
    "targetType": "image"
  }'

# → { "success": true, "data": { "taskId": "...", "creditsCost": 15 } }

Límites de vídeo: hasta 300 segundos para un intercambio simple y hasta 90 segundos cuando faceEnhance o frameEnhance está activado.

GET /api/v1/face-swap/{taskId}

Consulta el estado de la tarea. El campo status pasa de processing a succeeded o failed. Si tiene éxito, outputUrl contiene el resultado alojado. Los trabajos fallidos se reembolsan automáticamente.

curl https://aideepfake.io/api/v1/face-swap/TASK_ID \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "taskId": "...", "status": "succeeded",
#      "outputUrl": "https://...", "targetType": "image" } }

GET /api/v1/credits

Consulta tu saldo de créditos y tu plan actuales antes de enviar trabajos.

curl https://aideepfake.io/api/v1/credits \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "credits": 1000, "subscriptionCredits": 985,
#      "oneTimeCredits": 15, "planId": "...", "currentPeriodEnd": "..." } }

Precios y cuota

La API no tiene una tarifa aparte. Cada solicitud consume los créditos de tu plan de suscripción: 15 créditos por intercambio de imagen y 20 créditos por intercambio de vídeo, exactamente igual que la aplicación web. Tu cuota mensual de créditos la define tu plan.

Comparar planes

Códigos de error

HTTPCódigoSignificado
401INVALID_API_KEYLa clave API falta, no es válida, está desactivada o ha caducado.
403API_REQUIRES_SUBSCRIPTIONLa cuenta no tiene una suscripción activa. Suscríbete a un plan para usar la API.
402INSUFFICIENT_CREDITSLa cuenta no tiene créditos suficientes para este trabajo. Mejora tu plan o compra un paquete de créditos.
400VIDEO_TOO_LONGEl vídeo supera el límite de duración para las opciones seleccionadas.
429RATE_LIMITEDDemasiadas solicitudes. Reduce el ritmo y reintenta tras una breve espera.

Preguntas frecuentes

¿Quién puede usar la API de intercambio de caras?

Cualquier cuenta con un plan de suscripción activo. Las cuentas gratuitas pueden usar la aplicación web, pero no la API.

¿Cuánto cuestan las solicitudes a la API?

Lo mismo que la aplicación web: 15 créditos por intercambio de imagen y 20 créditos por intercambio de vídeo. Las solicitudes consumen el mismo saldo de créditos que tu uso web.

¿La API admite intercambio de caras en vídeo?

Sí. Establece targetType en video. Los intercambios de vídeo simples aceptan hasta 300 segundos; los intercambios con mejora de cara o de fotogramas aceptan hasta 90 segundos.

¿Cómo obtengo el resultado?

Consulta GET /api/v1/face-swap/{taskId} hasta que status sea succeeded. La respuesta incluye un outputUrl con el archivo de resultado alojado.

¿Qué ocurre cuando un trabajo falla?

Los trabajos fallidos se reembolsan automáticamente. La respuesta de estado incluye un campo error con el motivo.

¿Qué ocurre cuando termina mi suscripción?

Tus claves API dejan de funcionar de inmediato. Vuelven a funcionar cuando renuevas la suscripción: no necesitas claves nuevas.

Empieza a construir

Crea tu clave API y ejecuta tu primer intercambio de caras en minutos.

Crear una clave API