Reemplazo de Fondo

El endpoint de Reemplazo de Fondo te permite aislar un sujeto de una imagen y generar un fondo completamente nuevo y realista basado en una descripción de texto.

Nombre del Modelo: background-replace

Ciclo de Vida: estable

Tiempo de Procesamiento: ~5s–15s

Formato de Salida: Auto (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 reemplazo de fondo 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": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

Respuesta

Devuelve un estado 201 Created con el objeto de seguimiento inicial. La generación se ejecuta de forma asíncrona.

{
  "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" (mediante el sondeo del endpoint GET), el campo output contendrá un array con la URL que apunta a tu fondo generado:

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

Parámetros de Solicitud

Parámetros Obligatorios

subjectImageRequiredstring

La imagen que contiene el sujeto que deseas aislar. Puede ser una URL de acceso público o una cadena de imagen codificada en Base64. Tamaño máximo: 25MB.

Consejo Profesional: Los sujetos con bordes claros y nítidos contra un fondo contrastante obtienen los recortes más limpios. Evita imágenes donde el sujeto se mezcla con el fondo (por ejemplo, camisa blanca en pared blanca). La iluminación de alto contraste ayuda a la IA a depender de la detección de bordes para separar el sujeto perfectamente.

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

scenePromptRequiredstring

Una descripción textual de la nueva escena de fondo que deseas generar detrás del sujeto.

Parámetros Opcionales

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

Nivel de resolución de salida. Define la resolución de la imagen final generada. Por defecto: 1k

Errores de Tiempo de Ejecución

Los errores de 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 para Desarrolladores, el costo depende completamente del nivel de quality de salida elegido.

Fórmula: Costo = CréditosPorCalidad

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