Control de Pose

El endpoint de Control de Pose te permite tomar una imagen existente de un modelo y generar nuevas variaciones donde el modelo asume una postura corporal diferente. La IA preserva meticulosamente las características faciales, la vestimenta y el fondo del modelo.

Solicitud

Envía la imagen de tu modelo y una lista de las poses deseadas al endpoint universal /v1/run:

Ejemplos de Solicitud

Puedes reposicionar un modelo usando una imagen de referencia (plantilla) o una descripción de texto (personalizada).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Manos en las caderas"
               },
               {
                 "type": "custom",
                 "text": "Sentado en una silla con las piernas cruzadas"
               }
             ]
           }
         }'

Respuesta

Dado que la generación puede tardar hasta 30 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 estricto tiempo de espera 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": "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 poses 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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

Parámetros de Solicitud

Parámetros Obligatorios

Plantillas de Pose Oficiales

Aunque puedes proporcionar tus propias imágenes de referencia a través de cdnUrl, ofrecemos un directorio curado de plantillas de pose altamente optimizadas. Haz clic en cualquier URL a continuación para previsualizar la pose.

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 poses solicitadas y depende del nivel de quality de salida elegido.

Fórmula: Cost = QualityCredits × NumberOfPoses

Ejemplo: Solicitar un array de 3 poses con calidad 1k cuesta 3 créditos en total. Solicitar las mismas 3 poses con calidad 4k cuesta 15 créditos en total.