Intercambia prendas en modelos de moda con IA sin problemas utilizando referencias de imágenes.

Probador Virtual (Probador de Imagen)

El endpoint de Probador Virtual te permite ajustar una prenda a una persona sin problemas utilizando una referencia de imagen.

Nombre del Modelo: tryon

Ciclo de Vida: estable

Tiempo de Procesamiento: ~15s–30s

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

Métodos de Entrega: URL (mediante Sondeo)

Créditos: 1 × sampleCount

Solicitud

Envía tu configuración de probador virtual al endpoint universal /v1/run utilizando un payload JSON.

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": "tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "garmentImage": "https://example.com/garment.jpg",
             "accuracy": "high",
             "sampleCount": 1
           }
         }'

Respuesta

La generación del Probador Virtual ocurre de forma asíncrona en segundo plano. Tu solicitud devolverá inmediatamente un estado 200 OK con un objeto de seguimiento.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Sondeo de Resultados Debes usar el id devuelto para sondear el endpoint de estado (GET https://fititon.app/api/v1/status/{id}) y recuperar las URLs de tus imágenes generadas. Consulta la guía de Configuración de la API para obtener instrucciones detalladas.

Parámetros de Solicitud

Parámetros Obligatorios

personImageRequiredstring

La imagen base del modelo que quieres vestir. Puede ser una URL de acceso público o una cadena de imagen codificada en Base64. Formatos soportados: JPEG, PNG, WEBP. Tamaño máximo: 25MB.

Consejo Profesional: Las poses frontales con los brazos visibles producen el drapeado más realista. Retira bolsos, bufandas o chaquetas que cubran el cuerpo antes de la toma.

Requisito de Formato Al enviar una cadena Base64, debe incluir el prefijo URI de datos estándar (por ejemplo, data:image/jpeg;base64,...). El endpoint /v1/run solo acepta payloads JSON, por lo que las cargas multipart/form-data no son compatibles.

garmentImageRequiredstring

La imagen de la prenda de vestir para probar. Puede ser una URL de acceso público o una cadena de imagen codificada en Base64.

Consejo Profesional: Las fotos de prendas en plano sobre fondos blancos funcionan notablemente mejor que las tomas en percha o la ropa arrugada.

Parámetros Opcionales

accuracy'standard' | 'high' | 'hyper'

Define la fidelidad del ajuste del probador virtual. Una mayor precisión aumenta la exactitud de la generación, pero puede tardar un poco más. Por defecto: standard

sampleCountinteger

Número de variaciones de imagen a generar por solicitud. Debe estar entre 1 y 4. 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 Desarrollador, el endpoint de Probador Virtual opera a una tarifa plana de 1 crédito por imagen generada, independientemente del nivel de quality solicitado.

Fórmula: Costo = 1 × sampleCount

Parámetro	Créditos por Imagen
Tarifa Plana	1