ForHosting KIT · Imágenes

Cambiar el fondo

Este endpoint toma una foto y coloca un entorno distinto detrás del sujeto: un color de estudio, una escena de estilo de vida, un fondo de temporada, sin tocar el sujeto en sí. Es el paso siguiente al recorte, pensado para equipos que necesitan que el mismo producto o retrato luzca convincente en diez fondos diferentes.

● BetaPor solicitud + por imagen$0.062

Ejecutar — $0.062 + $0.004/imagen Cómo funciona y API

Úselo desde WebAPIEmailApp prontoTelegram pronto

Ejecútela online

Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.

La distancia entre un recorte y una foto terminada

Quitar el fondo le da un sujeto transparente, pero un sujeto transparente no es una foto terminada, es un activo a medio hacer que espera un contexto. Un zapato sobre la nada se ve inconcluso; un zapato sobre un degradado cálido se ve como página de catálogo. Este endpoint cierra esa distancia en una sola llamada: envía la foto de origen, indica qué debe reemplazar el fondo, y recibe de vuelta una imagen compuesta donde el sujeto se asienta con naturalidad en su nuevo entorno.

Color sólido o escena generada

Puede pedir un color plano (blanco puro para cumplir con las reglas de un marketplace, un tono de marca para una campaña, negro para contraste) o describir una escena y dejar que la tarea genere un entorno verosímil detrás del sujeto: una mesada de cocina, una terraza al aire libre, un fondo de estudio con sombra suave. En ambos casos lo difícil es el manejo del borde, y es justo para lo que está afinada la tarea: mantener creíble el contorno del sujeto incluso donde el pelo, los bordes de tela o los reflejos suelen delatar un mal montaje.

Quién recurre realmente a esto

Los equipos de producto lo usan para que una sola sesión de fotos sirva para cinco marketplaces, cada uno con su propia regla de fondo. Las plataformas de listados inmobiliarios lo usan para neutralizar fondos que distraen en fotos que suben los usuarios. Los equipos de marketing reutilizan una sola foto principal durante toda una temporada de campañas con solo cambiar lo que hay detrás, en vez de contratar un fotógrafo para cada fondo.

Composición sobre recorte, no en lugar de él

Si solo necesita transparencia, el endpoint de quitar fondo por sí solo es más barato y sencillo. Este es para el paso siguiente, cuando el sujeto transparente necesita un lugar real: un color, una sombra, una sensación de espacio, antes de entrar en un listado, un anuncio o un catálogo impreso.

Cómo encaja en un flujo de trabajo

Como la tarea corre de forma asíncrona, envía la foto y la instrucción de fondo, recibe un task_id de inmediato, y el resultado compuesto llega por un webhook firmado en el momento en que está listo, sin sondeo ni bloquear su flujo de carga. Encaja de forma natural después de un paso de subida y antes de uno de redimensionado o marca de agua, para que una sola foto pase por recorte, fondo y formato final sin salir nunca de su canal.

Qué puede hacer con ella

Listados que cumplen las reglas de un marketplace

Las fotos de producto de un vendedor se toman sobre una mesa de trabajo desordenada; a cada una se le aplica fondo blanco puro antes de subirla a un marketplace que lo exige.

Renovación de campaña por temporada

Una sola foto de estudio de un producto recibe un fondo nevado para invierno y una escena de playa para verano, sin reservar una nueva sesión para ninguna de las dos.

Limpieza de fotos inmobiliarias

Una foto de listado con un patio trasero desordenado o que distrae recibe un fondo neutral y ordenado antes de publicarse.

Catálogo de marca consistente

Un minorista estandariza cada foto de proveedor, sin importar su fondo original, sobre el mismo fondo de color de marca en todo el catálogo.

Preguntas frecuentes

¿Cómo cambio el fondo de una imagen con la api?

Haga un POST a /image/replace-background con la imagen de origen y un color objetivo o una descripción de escena; recibe un task_id y la imagen compuesta llega por webhook o por enlace firmado.

¿Puedo usar un color plano en vez de una escena generada?

Sí, puede indicar un color simple, incluido un tono de marca específico, o describir una escena y dejar que la tarea genere un entorno verosímil en su lugar.

¿Maneja bien el pelo y los bordes finos?

Está afinada para mantener bordes creíbles alrededor del sujeto incluso donde el pelo, la tela o los reflejos dificultan un montaje limpio, aunque el detalle muy fino es aproximado.

¿Hay un plan gratuito para la api de cambiar fondo?

No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.

¿Cuánto cuesta cambiar el fondo de una imagen?

$0.062 por solicitud más $0.004 por imagen, y solo se cobra por las tareas que se completan con éxito.

¿Está disponible ya la api de cambiar fondo?

Está en despliegue y todavía no acepta trabajos; el endpoint y el precio indicados son definitivos y estarán activos en breve.

¿En qué se diferencia de la api de quitar fondo?

Quitar fondo le da un recorte transparente; cambiar fondo va un paso más allá y compone el sujeto sobre un color o escena nuevos en la misma llamada.

¿Puedo procesar muchas fotos de producto a la vez?

Sí, combine este endpoint con la API de Procesamiento en Lote para aplicar el cambio de fondo a todo un catálogo, cada imagen cotizada y medida por separado.

Para desarrolladores — acceso por API

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

Endpoint de API

POSThttps://api.kit.forhosting.com/image/replace-background

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.

Llámela desde su stack

curl -X POST https://api.kit.forhosting.com/image/replace-background \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/image/replace-background", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/imagen.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/replace-background",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/replace-background", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/imagen.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/replace-background", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Ejemplo de solicitud

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.replace_background",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Precio

Por solicitud$0.062

Por imagen$0.004

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

Límites

`max_mb`	15
`max_megapixels`	12

Errores

HTTP	Código	Significado
`401`	`unauthorized`	API key ausente o inválida.
`402`	`insufficient_balance`	El saldo no cubre el precio de la tarea.
`404`	`unknown_type`	El tipo de tarea no existe.
`429`	`rate_limited`	Demasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →