Un solo endpoint

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.
Resultado de la llamada: el coche sobre un fondo neutrobackground=office-lot

El recorrido de un anuncio, de la foto a la ficha

entradaEl vendedor sube una fotoUn garaje, una entrada, un aparcamiento: lo que sea, también fotos de noche.
01Se localiza el cocheUna máscara separa la carrocería del fondo por su contorno, incluidos cristales y retrovisores.
02Se identifica el cocheMarca, modelo, tipo de carrocería y medidas, con un nivel de confianza.
03Se sustituye el fondoTu escena, una sombra ajustada al ángulo de la foto y la matrícula oculta o sustituida.
salidaPublicado en el listadoLa foto terminada y los datos en JSON, directos a tu cola de publicación.
La respuesta

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 }
  }
}
Un coche ante la ciudad al anochecer
Una sola llamada
10k
fotos en una sola tarea
01Lotes de hasta 10.000 fotos, webhook al terminar y reintentos si algo falla: todo de nuestra parte.
02Pagas por foto procesada, con precio según tu volumen.

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.

Fondo de la biblioteca «office-lot»office-lot
Fondo de la biblioteca «white-showroom»white-showroom
Fondo de la biblioteca «city-dusk»city-dusk
Fondo de la biblioteca «dark-showroom»dark-showroom
Conexión

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.

Cómo tratamos los datos que nos envías: consulta nuestra política de privacidad.