Mejorador de Calidad (Escalado)

El endpoint Mejorador de Calidad te permite escalar y mejorar de forma inteligente la resolución y los detalles más finos de las imágenes, soportando hasta una resolución de 4K.

Nombre del Modelo: upscale

Ciclo de Vida: stable

Tiempo de Procesamiento: ~8s–20s

Formato de Salida: Auto (JPEG o PNG)

Métodos de Entrega: URL

Créditos: 3 a 4 por imagen (2k: 3, 4k: 4)

Solicitud

Envía tu imagen y resolución objetivo al endpoint universal /v1/run:

POSThttps://fititon.app/api/v1/run

Ejemplos de Solicitud

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

Respuesta

Debido a que el escalado puede tardar hasta 20 segundos, el endpoint /v1/run devuelve un estado 201 Created inmediatamente con un id de trabajo asíncrono. Debes consultar la API de Estado usando este id para recuperar la imagen final. Alternativamente, puedes configurar webhooks para recibir notificaciones automáticamente. Ten en cuenta que nuestro despachador de webhooks impone un tiempo de espera estricto de 15 segundos. Tu servidor debe reconocer el webhook con un código de estado 2xx en un plazo de 15 segundos, o lo consideraremos fallido y lo reintentaremos más tarde.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

Cuando el trabajo se completa (status: "success"), el campo output contendrá el array de URLs resultantes:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Parámetros de Solicitud

Parámetros Obligatorios

imageUrlRequiredstring

La imagen de origen que deseas escalar. Puede ser una URL de acceso público o una cadena de imagen codificada en Base64.

Requisito de Formato y Carga Útil Al enviar una cadena Base64, debe incluir el prefijo URI de datos estándar (por ejemplo, data:image/jpeg;base64,...). Además, recomendamos encarecidamente utilizar URLs HTTP estándar para imágenes de más de 3MB para evitar alcanzar los límites globales de tamaño de carga útil JSON (HTTP 413).

targetQualityRequired'2k' | '4k'

El nivel de resolución de salida deseado. Nota: Las imágenes de más de 4.25 megapíxeles no pueden usar targetQuality="2k" y deben apuntar a 4k.

Errores en Tiempo de Ejecución

Los errores en tiempo de ejecución para esta característica utilizan el conjunto compartido documentado en Manejo de Errores. Si ocurre un error durante el procesamiento, el status se actualizará a "error" y el campo error contendrá la razón específica del fallo.

Costo de Créditos

Para las solicitudes de la API de Desarrollador, el costo escala según la targetQuality.

Fórmula: Costo = CréditosDeCalidad

Parámetro	Créditos por Imagen
`targetQuality="2k"`	3
`targetQuality="4k"`	4