API de Social Studio | Documentación para Desarrolladores de Fit It On

Aplica efectos creativos y plantillas altamente estilizadas a imágenes de moda para redes sociales.

El endpoint de Social Studio aplica plantillas estéticas creativas y altamente estilizadas a tus imágenes de moda, convirtiéndolas en contenido llamativo perfectamente adecuado para el marketing en redes sociales.

Nombre del Modelo: social-studio

Ciclo de Vida: estable

Tiempo de Procesamiento: ~15s–30s

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

Métodos de Entrega: URL

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

Solicitud

Envía tu imagen y el ID de estilo seleccionado 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": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Respuesta

Dado que la generación de imágenes 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 utilizando este id para recuperar la imagen final. 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 un plazo de 15 segundos, o lo consideraremos fallido y lo reintentaremos más tarde.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

Cuando el trabajo se complete (status: "success"), el campo output contendrá un array de las URLs resultantes:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Parámetros de Solicitud

Parámetros Obligatorios

personImageRequiredstring

La imagen de origen a estilizar. Puede ser una URL de acceso público o una cadena de imagen codificada en Base64.

Consejo Profesional: Las fotos de cuerpo entero donde la persona es completamente visible producen los mejores resultados estilizados. La visibilidad clara del rostro es importante: la IA utiliza las características faciales para crear tu versión estilizada. Evita fotos de grupo o imágenes donde estés parcialmente oculto detrás de objetos.

Requisito de Formato Al enviar una cadena Base64, debe incluir el prefijo URI de datos estándar (por ejemplo, data:image/jpeg;base64,...). Aunque personImage acepta cadenas Base64, recomendamos encarecidamente utilizar URLs HTTP estándar para imágenes de más de 3MB para evitar alcanzar los límites globales de tamaño de carga útil JSON (HTTP 413) en tu solicitud.

styleIdRequiredstring

El ID de estilo fotográfico a aplicar a la imagen generada. Esto determina la iluminación, la estética y el ambiente.

Estilos Disponibles:

Style Name	Style ID (`styleId`)

Parámetros Opcionales

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

Nivel de resolución de salida. Por defecto: 1k

sampleCountinteger

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

ratiostring

Anulación de la relación de aspecto. Si está vacío, el sistema por defecto usa 1:1 (ideal para feeds de Instagram/redes sociales).

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 Desarrolladores, 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)	2
2k	3
4k	5