Genera modelos de moda de IA completamente únicos o sube imágenes de referencia personalizadas para usar en pruebas virtuales.

Creación de Modelos

Creación de Modelos te permite generar modelos de moda realistas con indicaciones sencillas e intuitivas o imágenes de referencia, o subir imágenes de modelos existentes a tu espacio de trabajo.

Nombre del Modelo: model-create

Ciclo de Vida: stable

Tiempo de Procesamiento: ~10s–30s (aumenta al usar referencias avanzadas como cara/pose)

Formato de Salida: Auto (JPEG o PNG)

Métodos de Entrega: URL

Créditos: 1 a 5 por modelo (1k: 1, 2k: 3, 4k: 5)

Solicitud

Genera o sube modelos de moda enviando tu configuración 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": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Respuesta

Dado que la generación de modelos 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 tiempo de espera estricto de 15 segundos. Tu servidor debe acusar recibo del webhook con un código de estado 2xx en 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 con la URL que apunta a tu modelo generado:

{
  "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/model-123.png"
  ]
}

Parámetros de Solicitud

Parámetros Obligatorios

typeRequired'generate' | 'upload'

Especifica si se debe generar un nuevo modelo mediante IA (generate) o subir una imagen existente (upload).

nameRequiredstring

Un nombre descriptivo para tu modelo. Se utiliza para identificar el modelo en tu estudio.

promptstring

Obligatorio para la generación Descripción textual del modelo a generar. Describe el modelo de moda deseado, la ropa, la pose y la escena de fondo.

Consejo Profesional: Si utilizas una referencia como faceModelId, la IA priorizará la identidad de la referencia, pero utilizará tu prompt para determinar el entorno, el atuendo y las características corporales. Opcional solo si se proporciona un faceModelId.

imageBase64string

Obligatorio para la subida Cadena de imagen codificada en Base64. Obligatorio cuando type se establece en upload.

Requisito de Formato Tu cadena Base64 debe incluir el prefijo URI de datos estándar (por ejemplo, data:image/jpeg;base64,... o data:image/png;base64,...). La subida fallará si solo se proporciona la cadena codificada en bruto.

Parámetros de Generación Opcionales

Estos parámetros se aplican cuando type se establece en generate.

genderstring

El género del modelo. Ayuda al modelo de generación a determinar los atributos físicos.

bodyTypestring

El tipo de cuerpo del modelo (por ejemplo, "atlético", "talla grande", "delgado").

clothingstring

Detalles específicos de la ropa a aplicar durante la generación, complementando el prompt principal.

posestring

Descripción textual de la pose (por ejemplo, "de pie con las manos en los bolsillos", "caminando").

faceModelIdstring

UUID de un modelo de cara existente para fijar una identidad específica en todas las generaciones. La salida se adaptará al prompt objetivo mientras se preserva la cara de referencia.

Nota: Proporcionar una referencia facial añade varios segundos al tiempo total de procesamiento, ya que la IA alinea la identidad.

poseModelIdstring

UUID de un modelo de pose existente. Fuerza la generación a coincidir estrictamente con la referencia para la pose y postura del cuerpo.

Nota: Proporcionar una referencia de pose aumenta el tiempo de procesamiento.

poseImageBase64string

Cadena de imagen codificada en Base64 para usar como referencia de pose ad-hoc en lugar de proporcionar un poseModelId guardado.

quality'1k' | '2k' | '4k'

Nivel de resolución de salida. 1k produce una salida de ~1 megapíxel, 2k ~4 megapíxeles y 4k ~16 megapíxeles. Las resoluciones más altas consumen más créditos. Por defecto: 1k

aspectRatiostring

Define la relación de ancho a alto de la imagen generada.

Valores soportados: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Por defecto: 3:4

sampleCountinteger

Número de variaciones de imagen a generar por solicitud. Las imágenes adicionales consumen más créditos y aumentan el tiempo de procesamiento linealmente. Por defecto: 1

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 Desarrolladores, el costo depende del nivel de quality de salida elegido.

Nivel de Calidad	Créditos por Modelo
1k (Por defecto)	1
2k	3
4k	5