Cambiar el fondo
Ponga blanco puro detrás de un producto para una tienda en línea, el color de su marca para una campaña o una escena descrita, como una encimera de cocina o un fondo de estudio suave con sombra. El sujeto queda intacto y con bordes creíbles. Paga por uso, sin suscripción.
Esta tarea no está disponible ahora mismo, así que no se puede contratar. No se cobra nada por ella.
Cómo funciona y APIEs el paso siguiente al recorte, pensado para equipos que necesitan que el mismo producto o retrato luzca convincente en diez fondos diferentes.
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.
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.
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
¿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. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿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.
¿Puede una sola foto servir para varias tiendas con normas de fondo distintas?
Sí. Los equipos de producto aprovechan una única sesión de fotos para varias tiendas dando a cada copia el fondo que exige cada una, por ejemplo blanco puro para una y el color de marca para otra, sin repetir la sesión.
Herramientas relacionadas
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
Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. Esta capacidad está disponible actualmente mediante la API, no como herramienta interactiva en la Web.
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 '{"image":"https://example.com/photo.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://example.com/photo.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['KIT_KEY']}"},
json={
"image": "https://example.com/photo.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" => '{"image":"https://example.com/photo.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://example.com/photo.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://example.com/photo.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
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. |
Notas técnicas
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í.
La distancia entre un recorte y una foto terminada
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.
Composición sobre recorte, no en lugar de él
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. Si solo necesita transparencia, el endpoint de quitar fondo por sí solo es más barato y sencillo.
Cómo encaja en un flujo de trabajo
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. 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.
Preguntas técnicas
¿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.
¿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.
¿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.