Generación de Ángulos

El endpoint de Generación de Ángulos te permite tomar una imagen existente y reposicionar la cámara virtual para generar nuevos ángulos de visión (por ejemplo, perfiles frontales, traseros, laterales) mientras se preserva el modelo, la ropa, las texturas y la iluminación.

Solicitud

Envía tu imagen y los ángulos deseados al endpoint universal /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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Respuesta

Dado que la generación de ángulos 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 GET /v1/status/{id} para recuperar los resultados finales. 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 dentro de los 15 segundos, o lo consideraremos fallido y lo reintentaremos más tarde.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Una vez que el status cambie a "succeeded", el campo output contendrá un array de URLs que apuntan a tus imágenes generadas. Las imágenes se devuelven exactamente en el mismo orden que el array angleIds proporcionado en tu solicitud inicial:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

Parámetros de Solicitud

Parámetros Requeridos

Parámetros Opcionales

Errores en Tiempo de Ejecución

Los errores en tiempo de ejecución para esta función 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 Desarrolladores, el costo escala linealmente según el número de ángulos solicitados y depende del nivel de quality de salida elegido.

Fórmula: Costo = CréditosPorCalidad × NúmeroDeÁngulos

Ejemplo: Solicitar ["back", "leftSide", "rightSide"] con calidad 1k cuesta 3 créditos en total. Solicitar los mismos 3 ángulos con calidad 4k cuesta 15 créditos en total.