Configuración de la API

Para interactuar con la API para desarrolladores de Fit-it-on, debes autenticar tus solicitudes utilizando una clave de API de desarrollador segura.

Generación de una clave de API

1. Inicia sesión en tu Panel de Control de Fit-it-on.
2. Navega a Desarrollador > Claves de API en la barra lateral izquierda.
3. Haz clic en el botón Generar Nueva Clave.
4. Copia tu nueva clave secreta (siempre comenzará con fio_sk_...).

Autenticación

Todas las solicitudes a la API deben incluir tu clave de API en el encabezado Authorization como un token Bearer.

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

Flujo de trabajo asíncrono

Los puntos finales de generación de Fit-it-on (como /v1/run) operan de forma asíncrona. Esto significa que tu solicitud inicial regresará inmediatamente con un ID de seguimiento de trabajo, en lugar de esperar a que la generación se complete.

Paso 1: Enviar un trabajo

Realiza una solicitud POST a https://fititon.app/api/v1/run para poner en cola un trabajo de generación. Recibirás una respuesta inmediata:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Paso 2: Consultar los resultados

Utiliza el id devuelto para verificar periódicamente el estado de tu generación realizando una solicitud GET a https://fititon.app/api/v1/status/{id}.

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

La respuesta indicará el estado actual de tu trabajo. Cuando status sea "completed", el campo output contendrá las URLs de las imágenes o videos generados.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

Realizando tu primera solicitud

Puedes probar tu clave obteniendo tus créditos de desarrollador restantes y verificando tu plan:

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

Si tiene éxito, esto devolverá un objeto JSON con tu plan actual y los créditos restantes.