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

Crear Modelo

Crear Modelo 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.

Model Name: model-create

Ciclo de vida: stable

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

Formato de salida: Auto (JPEG or PNG)

Métodos de entrega: URL

Credits: 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 reconocer el 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 Requeridos

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

Requerido 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

Requerido para la carga Cadena de imagen codificada en Base64. Requerido 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 carga 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 mientras 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. Predeterminado: 1k

aspectRatiostring

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

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

Predeterminado: 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. Predeterminado: 1

Errores de Tiempo de Ejecución

Los errores de 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 depende del nivel de quality de salida elegido.

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