- Para quién es
- Portales y marketplaces
Cada vendedor hace su anuncio a su manera. El listado debería parecer uno solo.
Los vendedores hacen las fotos en garajes, entradas y aparcamientos. Pasa todo el flujo por una sola llamada POST y cada ficha del listado vuelve con un fondo común y, al lado, la marca, el modelo y las medidas para moderar.
curl -X POST https://auto.happyin.app/v1/frames \ -H "Authorization: Bearer $AUTO_API_KEY" \ -F "image=@ad_88213.jpg" \ -F "background=office-lot" \ -F "brand_rule=default"
POST /v1/batches
{
"background_id": "bgl_…",
"frames": [{ "name": "88213.jpg", "type": "image/jpeg", "size": 2400000 },
"… 499 more; the rest via POST /v1/batches/{id}/frames"]
}
# PUT each file to its uploads.frames[].url, then:
POST /v1/batches/{id}/submit
# once, not per batch:
POST /v1/webhooks
{ "url": "https://api.company.com/hooks/car", "events": ["batch.completed"] }import { Client } from "@happyin/auto";
const client = new Client(); // key from AUTO_API_KEY
const { image_url, vehicle } = await client.processFrame("ad_88213.jpg", {
background: "office-lot",
});
if (vehicle?.make?.code !== ad.make) flagForReview(ad.id);Llamada síncrona: la foto procesada y los datos del vehículo llegan en la misma respuesta.Lotes de hasta 10.000 fotos y un webhook al terminar. Los reintentos corren de nuestra cuenta.SDK para Node y Python, con los mismos campos que la API REST.
El recorrido de un anuncio, de la foto a la ficha
No solo una imagen. También datos para moderar.
El modelo reconoce el coche en la foto, diga lo que diga el vendedor en el título. Compara ambos datos y detecta errores y fotos de otro coche antes de publicar.
vehicle.make / modelLa marca y el modelo según la foto, no según el título del anuncio.vehicle.bodyTipo de carrocería: berlina, liftback, todocamino, familiar.vehicle.dimensions_mmLargo, ancho, alto, batalla, altura libre al suelo.vehicle.*.confidenceConfianza del modelo: tú fijas el umbral para la moderación automática.brand.plateLa matrícula detectada: oculta, sustituida o sin tocar.{
"ok": true,
"frame": {
"id": "frm_6f1d0c9a2b8e4f7a9c3d5e1b0a2f4c6d",
"status": "done",
"image_url": "https://…/ad_88213.png?X-Amz-Expires=600&…",
"vehicle": {
"status": "unconfirmed",
"make": { "code": "skoda", "text": "Škoda", "source": "estimate", "confidence": 0.89 },
"body": { "code": "liftback", "source": "estimate", "confidence": 0.93 },
"dimensions_mm": {
"length": 4690, "width": 1830, "height": 1470,
"wheelbase": 2690, "source": "estimate"
}
},
"brand": { "plate": "replaced", "overlays": 0 }
}
}
El fondo de tu plataforma, parte de tu marca
Envíanos tu escena una sola vez y la añadimos a tu biblioteca de fondos. Una regla de marca por defecto (POST /v1/brand/rules) la aplica a todos los anuncios.




Una clave de prueba, al momento y con sandbox.
La clave llega por correo y el sandbox devuelve los mismos campos que producción. Tu desarrollador puede integrarlo por su cuenta; si necesitas ayuda, lo conectamos juntos en una llamada.
Precio según tu volumen; para más de 100.000 fotos al mes hay una tarifa aparte.