Prueba de Prompt

El endpoint de Prueba de Prompt te permite describir un nuevo atuendo usando texto para vestirlo sin problemas en un modelo de moda de IA.

Nombre del Modelo: prompt-tryon

Ciclo de Vida: estable

Tiempo de Procesamiento: ~15s–40s (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 configuración de prueba al endpoint universal /v1/run:

POSThttps://fititon.app/api/v1/run

Ejemplos de Solicitud

Autenticación Puedes pasar tu clave API como un token Bearer (Authorization: Bearer TU_CLAVE_API) o a través del encabezado x-api-key (x-api-key: TU_CLAVE_API).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

Respuesta

La generación de la Prueba de Atuendo 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.

Cuando la generación finaliza, el endpoint de sondeo devolverá status: "success" con el siguiente array output que contiene las URLs de las imágenes finales:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

Parámetros de Solicitud

Parámetros Requeridos

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 admitidos: JPEG, PNG, WEBP. Tamaño máximo: 25MB.

Consejo Profesional: Las poses frontales con los brazos visibles producen el drapeado más realista.

Requisito de Formato Al enviar una cadena Base64, debe incluir el prefijo estándar de URI de datos (por ejemplo, data:image/jpeg;base64,...). El endpoint /v1/run solo acepta cargas útiles JSON.

promptRequiredstring

Descripción textual del atuendo que deseas que use el modelo.

Consejo Profesional: Incluye el tipo de tela (seda, algodón, mezclilla) y el estilo de ajuste (ajustado, extragrande) para obtener los mejores resultados. Especifica los colores con precisión ("azul marino" funciona mejor que "azul") y haz referencia explícitamente a lo que el modelo ya lleva puesto para que la IA sepa exactamente qué cambiar.

Parámetros Opcionales

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

Nivel de resolución de salida para Prueba de Prompt (modelos Gemini). Las resoluciones más altas consumen más créditos. Predeterminado: 1k

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

ratiostring

Define la relación ancho-alto de la imagen generada. Si está vacío, el sistema utiliza por defecto la relación de aspecto de la personImage.

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

modelImageUrlstring

Opcional. URL de un modelo de referencia humano para usar en lugar de preservar las características de la persona original.

Modelos Preestablecidos Disponibles:

styleIdstring

Opcional. Aplica un estilo fotográfico específico a la imagen de salida.

Estilos Disponibles:

Style Name	Style ID (`styleId`)

Valores válidos: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

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

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

El costo depende del nivel de quality seleccionado y se multiplica por tu sampleCount.

Fórmula: Costo = CréditosPorCalidad × sampleCount

Parámetro	Créditos por Imagen
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5