Separar Capas

Propósito

Este endpoint separa la imagen subida en capas. Extrae elementos específicos de la imagen basándose en palabras clave como capas individuales.

Método y Ruta

• HTTP Method: POST
• Path: /public/v1/image-tune/split-layer

Autenticación

Este endpoint requiere autenticación Bearer Token. Consulta la guía de autenticación para más detalles.

Encabezados Requeridos:

Authorization: Bearer {your_api_key}

Campos de Solicitud

Form Data (multipart/form-data)

Nombre del Campo	Tipo	Requerido	Descripción
image	file	Requerido	Archivo de imagen original para separar en capas (PNG, JPG, JPEG, etc.)
keyword	string	Requerido	Palabra clave especificando el elemento a separar

Guías de Palabra Clave

• Ingresa una palabra clave que describa el elemento de imagen que deseas separar
• Ej: "arm", "body", "leg"

Respuesta

JobIdResponse

Nombre del Campo	Tipo	Descripción
job_id	UUID	Identificador único del trabajo creado. Usa este ID para consultar el estado del trabajo

Reglas de Error / Validación

Código HTTP	Situación de Error	Descripción
400 Bad Request	Invalid image file	Invalid image file
401 Unauthorized	Fallo de autenticación	Clave de API inválida o encabezado de autenticación faltante
404 Not Found	Usuario no encontrado	No se puede encontrar el usuario vinculado a la clave de API
422 Unprocessable Entity	Fallo de validación	Campo requerido faltante

Comportamiento de Trabajos Asíncronos

Este endpoint se procesa de forma asíncrona. Devuelve inmediatamente un job_id, y el procesamiento real de separación de capas ocurre en segundo plano.

Flujo del Trabajo:

1. Envía el archivo de imagen y la palabra clave, y se devuelve inmediatamente un job_id
2. El procesamiento de separación de capas ocurre en segundo plano
3. Haz polling al endpoint GET /job/{job_id} para verificar el estado
4. Cuando status cambia a Succeed, consulta las URLs de las capas separadas en image_urls

Intervalo de Polling: Se recomienda 1-2 segundos

Ejemplo de Solicitud

cURL

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/split-layer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "keyword=character"

Ejemplo de Respuesta

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}