Mockups de producto
Una foto de producto sobre fondo blanco rara vez vende sola: necesita un entorno que muestre cómo se usa o dónde encaja. Este endpoint toma la imagen de su producto y la coloca dentro de una escena generada, produciendo un mockup de estilo lifestyle sin necesidad de sesión fotográfica.
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.
El problema: todo producto necesita contexto, no todo vendedor tiene un estudio
Una foto de producto de estudio demuestra que el artículo existe y muestra su forma, pero ayuda poco a que el comprador se imagine el producto en su cocina, en su escritorio o puesto en la calle. Producir ese contexto de forma tradicional implica una sesión fotográfica, un estilista y una locación, nada realista para un vendedor con cientos de referencias o una marca pequeña probando una línea nueva. Este endpoint reemplaza esa sesión con un paso de generación: le da su imagen de producto y una descripción de la escena, y compone ambas cosas.
Qué envía y qué recibe
Envía la imagen de su producto, por URL o archivo, junto con una descripción de la escena en la que quiere colocarlo, una mesada de cocina, un entorno exterior, un fondo de estudio minimalista con accesorios, y la tarea devuelve un mockup generado con su producto compuesto en ese ambiente. Como el endpoint es asíncrono, recibe un task_id de inmediato y el mockup terminado llega después por webhook o por un enlace firmado, reflejando el tiempo real que toma un trabajo de render o composición.
Por qué colocar un producto real en una escena generada es más difícil de lo que parece
Generar una escena desde cero es un problema; mantener su producto específico luciendo como él mismo mientras se ubica dentro de esa escena es otro problema, más difícil, porque el modelo tiene que respetar la forma, proporciones y detalles reales del producto en lugar de reinventarlos. Esa es la distinción técnica central entre este endpoint y la generación de imágenes común: el producto es una entrada fija que hay que preservar, no un sujeto para reimaginar, y la escena generada tiene que construirse alrededor de esa restricción.
Dónde encaja en un flujo de catálogo o lanzamiento
Como los resultados llegan de forma asíncrona, este endpoint se integra de manera natural en un flujo de publicación de productos: un vendedor sube una foto limpia del producto, el sistema solicita varios mockups en distintos entornos, y cada uno llega por webhook listo para asociarse a un listado o a una pieza de marketing. Combina bien con el quitado de fondo como paso previo, ya que un producto ya aislado de su fondo original suele componerse de forma más limpia dentro de la nueva escena.
Qué calidad esperar
El mockup es una composición generada, no una fotografía física, así que la iluminación y las sombras se infieren en lugar de capturarse, y los detalles muy pequeños o intrincados del producto pueden no sobrevivir perfectamente a la composición. Para la mayoría de los usos de catálogo, marketing y redes sociales, esa relación de costo y beneficio es una clara ventaja frente a no tener ninguna imagen lifestyle; para una foto principal de una campaña grande, trate el mockup generado como un borrador sólido para revisar antes de usarlo como pieza final.
Qué puede hacer con ella
Listados de marketplace sin sesión fotográfica
Un vendedor pequeño sube una foto simple de producto y genera varios mockups lifestyle para usar en su listado en lugar de reservar un estudio.
Probar una línea de producto nueva rápidamente
Una marca genera mockups de un prototipo en distintos entornos para medir el interés antes de destinar presupuesto a una sesión fotográfica completa.
Variedad de escenas en el catálogo
Una tienda en línea genera el mismo producto en varias escenas distintas, cocina, oficina, exteriores, para dar más contexto al comprador sin repetir ninguna sesión de fotos.
Creatividades de anuncio a partir de fotografía existente
Un equipo de marketing de rendimiento convierte una sola foto de producto aprobada en varios mockups con distintas escenas para probar en diferentes espacios de anuncio.
Preguntas frecuentes
¿Cómo genero un mockup de producto con la api?
Envíe un POST a /image/product-mockup con la imagen de su producto y una descripción de la escena en la que quiere colocarlo; recibe un task_id y el mockup llega por webhook o por un enlace firmado.
¿Mi producto se va a ver exactamente igual que en la foto original?
La tarea busca preservar la forma y los detalles reales del producto mientras genera la escena alrededor, pero como en cualquier composición generada, los detalles muy finos pueden no renderizarse a la perfección, sobre todo a escala pequeña.
¿Qué tipo de escenas puedo pedir?
Cualquier escena que pueda describir en texto, una mesada de cocina, un entorno exterior, un fondo de estudio con accesorios, es un objetivo válido para la composición del mockup.
¿Debería quitar el fondo de la foto de mi producto primero?
Ayuda. Un producto ya aislado de su fondo original tiende a componerse de forma más limpia dentro de la nueva escena generada.
¿Hay un plan gratuito para la api de mockups de producto?
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 un mockup de producto?
$0.002 por solicitud más $0.0065 por imagen, y solo se cobran los mockups que la tarea efectivamente completa.
¿Qué pasa si falla la generación del mockup?
La tarea reintenta automáticamente hasta tres veces; si aun así no puede completarse, recibe un error claro y nunca se cobra el intento fallido.
¿Puedo generar mockups para muchos productos a la vez?
Envíe una solicitud asíncrona por cada imagen de producto en paralelo y recoja cada mockup terminado a medida que se dispara su webhook, lo que escala bien en todo un catálogo.
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
¿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/product-mockup \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/imagen.jpg"}'const res = await fetch("https://api.kit.forhosting.com/image/product-mockup", {
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/product-mockup",
headers={"Authorization": f"Bearer {os.environ['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/product-mockup", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"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/product-mockup", 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.product_mockup",
"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. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |