Transforma fotos de productos en plano o con maniquí fantasma en fotografía profesional con modelo.

Producto a Modelo

El endpoint de Producto a Modelo transforma fotos de productos en plano o con maniquí fantasma en fotografía profesional con modelo, permitiéndote especificar la apariencia del modelo o el estilo fotográfico.

Nombre del Modelo: product-to-model

Ciclo de Vida: estable

Tiempo de Procesamiento: ~10s–30s (aumenta al usar referencias de estilo o modelo)

Formato de Salida: Automático (JPEG o PNG)

Métodos de Entrega: URL

Créditos: 1 a 5 por generación (depende de la calidad)

Solicitud

Envía tu imagen de producto 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": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

Respuesta

Dado que la generación de imágenes 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 con la URL que apunta a tu imagen generada:

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

Parámetros de Solicitud

Parámetros Obligatorios

productImageRequiredstring

La imagen del producto a colocar en un modelo (en plano o con maniquí fantasma). Puede ser una URL de acceso público o una cadena de imagen codificada en Base64. Tamaño máximo: 25MB.

Consejo Profesional: Las fotos en plano sobre fondos blancos producen los resultados más consistentes con modelo. Las fotos de maniquí también funcionan bien. Elimina etiquetas, pegatinas de precios o accesorios que no formen parte de la prenda antes de la toma. Asegúrate de que toda la prenda sea visible y esté desplegada, sin mangas cortadas.

Requisito de Formato Al enviar una cadena Base64, debe incluir el prefijo estándar de URI de datos (por ejemplo, data:image/jpeg;base64,...).

Parámetros Opcionales

customPromptstring

Instrucciones textuales que describen el modelo deseado (por ejemplo, género, etnia, pose) o la escena. Longitud máxima: 500 caracteres.

modelImageUrlstring

La URL de un modelo de referencia humano para usar en la generación. Si se omite, se generará un modelo diverso aleatorio.

Modelos Preestablecidos Disponibles:

Nota: Suministrar un modelo de referencia aumenta el tiempo total de procesamiento.

styleIdstring

El ID del estilo fotográfico a aplicar (por ejemplo, "studio", "iphone", "editorial"). Si se omite, se utiliza por defecto una presentación de estudio neutral.

Estilos Disponibles:

Style Name	Style ID (`styleId`)

Nota: Los estilos complejos pueden aumentar el tiempo de generación.

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. Por defecto: 1k

sampleCountinteger

Número de variaciones de imagen a generar por solicitud. Debe estar entre 1 y 4. Por defecto: 1

ratiostring

Define la relación ancho-alto de la imagen generada. Si está vacío, el sistema por defecto usa 3:4 para tomas de moda.

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

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 Desarrollador, el costo depende del nivel de quality de salida elegido multiplicado por el sampleCount.

Fórmula: Costo = CréditosPorCalidad × sampleCount

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