Fundamentos de la API

La API para desarrolladores de Fit-it-on proporciona acceso programático a nuestros modelos de generación de IA. Sigue los estilos arquitectónicos REST estándar, utiliza URL predecibles orientadas a recursos y acepta cuerpos de solicitud codificados en JSON.

Ejecución Asíncrona

Todas las generaciones de imágenes se procesan de forma asíncrona. Los renders de IA de alta resolución (2k o muestras de 2048x2048) llevan tiempo, y una conexión síncrona inevitablemente agotaría el tiempo de espera.

Enviar un Trabajo: Usted envía una solicitud POST /v1/run con sus datos de entrada.
Recibir ID: La API devuelve inmediatamente un 200 OK con un prediction_id.
Sondear el Estado: Usted llama periódicamente a GET /v1/status/{predictionId}.
Finalización: Cuando el estado cambia a succeeded, las URL de sus imágenes generadas estarán disponibles en el array output.

Soporte de Webhooks Alternativamente, puede proporcionar un parámetro webhook_url en su solicitud POST inicial. Una vez que el trabajo termine de procesarse (ya sea que tenga éxito o falle), enviaremos una solicitud POST directamente a su webhook que contendrá la carga útil del estado final, eliminando la necesidad de sondear manualmente.

URL Base

Todas las solicitudes deben realizarse a través de HTTPS a nuestro entorno de producción:

https://fititon.app/api

Tipos de Contenido

Todas las solicitudes POST y PATCH deben incluir el siguiente encabezado para especificar el formato de la carga útil:

Content-Type: application/json

La API también devuelve todas las respuestas estrictamente en formato JSON.

Webhooks

Si proporciona una webhook_url en la raíz de su carga útil JSON, enviaremos una solicitud HTTP POST a esa URL tan pronto como el trabajo asíncrono se complete (ya sea con éxito o con un error).

Ejemplo de Carga Útil del Webhook:

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

Límites y Manejo de Solicitudes

Para prevenir el abuso, la API aplica un límite de tasa basado en su nivel de Plan de Desarrollador activo.

Si excede su límite, recibirá un error 429 Too Many Requests. Su aplicación debe manejar esto de manera elegante implementando una retirada exponencial.

Su saldo de créditos es independiente del límite de tasa. Puede monitorear su uso general de la API y el saldo de créditos restante a través del Panel de Desarrollador, o programáticamente a través de los puntos finales de la cuenta.

Si la generación falla internamente (por ejemplo, se pasó una imagen no válida o se produjo un tiempo de espera del modelo), el punto final GET /v1/status devolverá un estado de failed, y la propiedad error contendrá un mensaje descriptivo. Sus créditos no serán deducidos por trabajos fallidos.