Mejorar calidad

Propósito

Este endpoint mejora la calidad de las imágenes subidas a resoluciones más altas. Amplía la imagen original a una resolución de 1K, 2K o 4K para producir imágenes más nítidas y de mayor calidad. Es la misma función que la página "Mejorar calidad" de la aplicación web, donde 2K está seleccionado por defecto.

Costo en créditos: 5 (1K), 7 (2K), 10 (4K)

Método y Ruta

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

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 a mejorar (PNG o JPEG)
scale	string	Requerido	Resolución objetivo. Valores posibles: "1K", "2K", "4K"

Valores de Scale

• "1K": Mejora a una resolución de 1024px
• "2K": Mejora a una resolución de 2048px
• "4K": Mejora a una resolución de 4096px

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 o valor de scale inválido

Comportamiento de Trabajos Asíncronos

Este endpoint se procesa de forma asíncrona. Devuelve inmediatamente un job_id, y el procesamiento real de mejora de calidad ocurre en segundo plano.

Flujo del Trabajo:

1. Envía el archivo de imagen y el parámetro scale, y se devuelve inmediatamente un job_id
2. El procesamiento de mejora de calidad ocurre en segundo plano
3. Haz polling al endpoint GET /job/{job_id} para verificar el estado
4. Cuando status cambia a Succeed, consulta la URL de la imagen resultante 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/upscale" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "scale=2K"

Ejemplo de Respuesta

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