Preguntas, respondidas

Convierte la descripción de un vehículo en una imagen de estudio con calidad fotográfica. Usted envía marca, modelo, año, variante y acabado, o un VIN o una matrícula, y recibe una URL de imagen firmada que puede poner directamente en una etiqueta img. Sin sesión de fotos, sin banco de imágenes, sin retoque.

Una clave de API en una cabecera x-api-key, y nada más. Todo el catálogo es una ruta de URL, así que puede explorarlo con curl antes de escribir una línea de código. La documentación empieza con una petición que funciona.

GET /api/search?q=vw+golf compara texto libre con todas las marcas y modelos, y perdona apodos, erratas y espaciados raros. Responde con rutas de catálogo que puede seguir recorriendo. Si pone un año en la consulta no habrá coincidencia, los años están un nivel más abajo.

Sí. La página de ejemplos es un mercado de demostración en vivo: cada imagen se obtiene de la API mientras usted navega, y puede cambiar el ángulo, repintar el coche y cambiar el fondo usted mismo. Si lo quiere sobre sus propios vehículos, envíenos unos cuantos y le devolvemos las imágenes, normalmente el mismo día laborable.

Hay un paquete en npm y un servidor MCP para agentes de IA. Ninguno es obligatorio. Es un endpoint HTTPS que devuelve una URL de imagen, y eso ya sabe manejarlo cualquier plataforma.

La mayoría de equipos tienen una imagen en una página el mismo día que reciben la clave, porque la integración es una URL. Pasar de ahí a producción suele ser una cuestión de dónde cachear, no de cuánto código escribir.

100 marcas y más de 65.000 modelos, de años actuales y anteriores. GET /api/brands devuelve la lista real de su clave en cualquier momento, así que nunca tiene que fiarse de una cifra en una página de marketing. Ver la cobertura.

Las generaciones anteriores están cubiertas, y eso importa más de lo que se cree: los anuncios de ocasión, los catálogos de remarketing y las guías de compra tratan sobre todo de coches que salieron de las salas hace años. GET /api/{brand}/{model} lista todos los años de modelo disponibles para ese modelo.

No. Furgonetas, vehículos industriales, pickups y motos se renderizan con el mismo aspecto de estudio, así que una página de flota mixta sigue leyéndose como un solo catálogo. Justo por eso hay una moto en la cuadrícula de la página de ejemplos.

La API lo dice en lugar de adivinar, así que usted obtiene una bifurcación en su código en lugar de un coche equivocado en una página. Cuando un año de modelo solicitado no existe, ajusta a la generación disponible más próxima y lo indica en errornotes.

De forma continua, a medida que los datos del fabricante están disponibles. Para leasing y configuradores eso es lo decisivo: un modelo suele existir en el catálogo meses antes de que se fabrique el primero, que es justo cuando la página de oferta lo necesita.

Sí, GET /api/getall vuelca en una sola respuesta todas las configuraciones disponibles para su clave. Es grande a propósito y está pensada para una sincronización nocturna, no para la carga de una página. Ver el endpoint.

Sí, las claves pueden limitarse, y GET /api/me informa de cualquier restricción en blocked_brands y year_range. Útil cuando un acuerdo de concesión solo cubre parte del mercado.

Nueve vistas: ocho ángulos exteriores (frontal, trasera, ambos laterales y las cuatro de tres cuartos) más tomas de interior como la consola central cuando el vehículo la tiene. Cada una es una petición aparte sobre la misma configuración, con el mismo encuadre de estudio. Verlas todas.

Sí, y el cambio repinta la toma de estudio real, así que un metalizado sigue leyéndose como metalizado. Hay cinco colores propios disponibles en todos los vehículos, encima llegan los colores de catálogo de cada marca, y también hay vinilos 3M. GET /api/{...}/colors lista lo que ofrece un coche concreto. Ver los colores.

Cuatro opciones, cada una un solo parámetro: shadow=true para una sombra proyectada de estudio, ground=true para una sombra de contacto que apoya el coche en una superficie, mirroring=true para un suelo reflectante de sala de exposición y transparency=true para un recorte limpio que puede colocar sobre cualquier cosa. Ver la diferencia.

PNG, WebP, JPEG y AVIF, con anchos de 200, 400, 800, 1200, 1600 o 2000 píxeles, y calidad entre 40 y 100 (82 por defecto). También hay ajustes con nombre, de thumb (320 px) a full (2000 px), si prefiere no elegir cifras.

De origen 3:2. Si pide otra proporción, la imagen se rellena en lugar de recortarse, así que nunca se corta nada del coche: 1:1, 4:3, 16:9, 16:10, 2:1, 21:9 y sus equivalentes verticales están todos disponibles. Por eso una tarjeta cuadrada y un banner panorámico pueden usar el mismo vehículo sin un diseñador de por medio.

Sí, transparency=true devuelve un recorte con canal alfa real. Conviene saberlo: la transparencia fuerza PNG, y un PNG pesa varias veces más que el mismo coche en WebP. Úselo donde realmente necesite el alfa y WebP en el resto.

En un plan normal, no. GET /api/me le dice exactamente qué permite su clave, incluido si se fuerza una marca de agua.

De eso trata renderizar en lugar de recopilar. Cada vehículo usa la misma posición de cámara, la misma distancia y la misma luz, así que una tabla mixta compara coches en lugar de comparar fotógrafos. Es la razón por la que los equipos de flota y leasing acaban aquí.

Es una ruta: /api/{brand}/{model}/{year}/{variant}/{trim}/{view}. Un GET sobre cualquier prefijo más corto lista el nivel siguiente, así que todo el árbol se descubre recorriéndolo. No hay un esquema que aprender antes de la primera petición.

Sí. Un VIN funciona en todas partes; la consulta por matrícula depende del mercado. La marca, el modelo, el año y el acabado también resuelven, y a menudo es todo lo que contiene un formulario de anuncio o una declaración de flota. Más sobre las búsquedas.

Cada configuración tiene un id permanente. GET /api/id/{id} devuelve todas las vistas disponibles, GET /api/id/{id}/{view} una sola. Los id sobreviven a las actualizaciones de catálogo y a los cambios de nombre, así que puede guardarlos con seguridad en su propia base de datos.

Sí, y la mayoría de integraciones lo hacen. Copie la imagen a su propio almacenamiento y sírvala desde ahí, para que la carga de una página nunca dependa de una llamada a nosotros. Las URL firmadas siguen siendo válidas siete días, tiempo de sobra para descargarlas y guardarlas.

Recurre al valor válido más próximo y le dice qué hizo en errornotes, en lugar de fallar. Hay 17 códigos, cada uno con un significado en lenguaje claro, para que pueda registrarlos o ignorarlos a conciencia. Ver los códigos.

Normalmente muchas menos de las que parece. Las configuraciones idénticas se resuelven en el mismo render, así que cuarenta furgonetas iguales dadas de baja son una sola imagen reutilizada. Cachee en su lado y una pantalla que muestra los mismos veinte vehículos a todos los visitantes cuesta veinte peticiones en total, no veinte por visitante.

Es una URL HTTPS normal, así que su cargador de imágenes y su caché en disco la manejan sin cambios, tanto en nativo como en un webview. Pida el ancho que usa realmente el diseño en lugar de reducir en el dispositivo una imagen pensada para imprenta. Más para equipos de apps.

No, y a propósito: el catálogo se consulta, no se envía. Sincronícelo cuando quiera con GET /api/getall, o lea el changelog para ver qué se ha publicado. Nada necesita un endpoint por su parte.

Se sirven desde una caché global en el edge, así que el primer byte llega desde una ubicación cercana al visitante y no desde un servidor de origen. Una variante se genera una vez y después se sirve desde caché.

Sí. La página de estado muestra disponibilidad y tiempos de respuesta en vivo, medidos fuera de nuestra propia infraestructura. GET /api/status es una comprobación de disponibilidad legible por máquina para su propia monitorización.

Las variantes en caché no llegan a la API, que es lo normal en una página de catálogo donde cada visitante ve los mismos vehículos. Por eso un día de lanzamiento o de campaña se comporta igual que un martes.

Nada, si ha seguido el patrón habitual: copie la imagen una vez a su propio almacenamiento y sírvala desde ahí. Su página dependerá entonces de su CDN, no del nuestro. Es lo más útil que puede construir pronto.

Se renderizan a partir de datos de vehículos que licenciamos. No son fotografías y no se extraen de webs de concesionarios ni de dosieres de prensa. Por eso podemos poner por escrito los usos permitidos, que suele ser la pregunta con la que empieza la conversación con un departamento jurídico.

Sí. Anuncios, aplicaciones, campañas, imprenta y documentos de cliente están cubiertos, sin crédito de imagen y sin marca de agua. Díganos qué documentos produce y quedará expresamente en la licencia.

Sí, y para aseguradoras y financieras ese suele ser justo el objetivo: presupuestos, condiciones de póliza, contratos y correspondencia de siniestros. En seguros y financiación explicamos cómo se monta normalmente.

No. No hay nadie en la imagen ni ninguna localización, lo que elimina toda una categoría de gestión de derechos que la fotografía trae consigo.

Identificadores del vehículo y nada más. Un VIN puede enviarse sin la póliza, el pedido o el cliente al que pertenece, así que nada relativo a una persona necesita salir de sus sistemas.

Muestra el modelo, el acabado y el color de fábrica registrado, que es como siempre se han usado las imágenes de fabricante. No es una fotografía de una unidad concreta y no debería etiquetarse como tal. La mayoría de plataformas la presentan como imagen representativa de esa configuración y reservan las fotos reales para la galería.

Mostrarlas a sus usuarios está cubierto por defecto. Permitir que los usuarios las descarguen o redistribuyan es un derecho distinto, así que díganos si lo necesita y quedará escrito de forma expresa en la licencia en lugar de quedar en el aire.

Por configuraciones distintas, no por páginas vistas, y por eso la curva de coste se aplana justo donde está el volumen: un modelo que publica mil veces no son mil renders. Ver los planes.

Una mezcla aproximada de modelos y cuántos vehículos publica o sirve al mes. Con eso basta. Para una empresa de alquiler es la lista de categorías, para una financiera la mezcla de derivados, para un portal el número mensual de anuncios.

No. Un intermediario con un puñado de propuestas a la semana y un portal con millones de anuncios reciben las mismas imágenes y las mismas opciones.

GET /api/me lo responde en una sola llamada: funciones habilitadas, formatos permitidos, resoluciones, proporciones, vistas, colores y marcas, además de cualquier restricción y la vigencia de las URL firmadas. Ver el endpoint.

No. Una configuración se renderiza una vez; cada petición posterior de la misma combinación se sirve desde caché. Por eso un portal que publica mil veces el mismo modelo no paga mil veces.

Escríbanos o reserve una llamada breve. Las respuestas suelen llegar el mismo día laborable, y vienen de quienes construyen esto, no de una cola de tickets.

Envíenos la marca, el modelo y el año. Añadir un modelo es trabajo normal para nosotros, no un favor, y suele ser la vía más rápida para saber si una laguna es un problema de datos o una discrepancia de nomenclatura.

Pregunte. Un ángulo concreto, un tratamiento de fondo o un formato de entrega que no esté en la lista merece una conversación; parte de lo que hoy es estándar empezó porque un cliente lo pidió.