Logo

Prueba Virtual

Intercambia prendas en modelos de moda de IA sin problemas usando referencias de imagen.

Prueba Virtual (Prueba de Imagen)

El endpoint de Prueba Virtual te permite ajustar una prenda a una persona sin problemas usando 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 prueba virtual al endpoint universal /v1/run usando 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 de la Prueba 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 deseas vestir. Puede ser una URL de acceso público o una cadena de imagen codificada en Base64. Formatos compatibles: 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 perchas o la ropa arrugada.

Parámetros Opcionales

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

Define la fidelidad del ajuste de la prueba virtual. Una mayor precisión aumenta la exactitud de la generación, pero puede tardar un poco más. Predeterminado: 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. Predeterminado: 1

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 endpoint de Prueba 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ámetroCréditos por Imagen
Tarifa Plana1