Вопросы и ответы

Он превращает описание автомобиля в студийное изображение фотографического качества. Вы отправляете марку, модель, год, версию и комплектацию, либо VIN или госномер, и получаете подписанный адрес изображения, который можно сразу вставить в тег img. Без съёмки, без фотобанка, без ретуши.

Ключ API в заголовке x-api-key — и больше ничего. Весь каталог представляет собой путь URL, поэтому его можно изучить через curl ещё до первой строчки кода. Документация начинается с рабочего запроса.

GET /api/search?q=vw+golf сопоставляет свободный текст со всеми марками и моделями и прощает прозвища, опечатки и странные пробелы. В ответ приходят пути каталога, по которым можно идти дальше. Год в запросе совпадения не даст, годы лежат уровнем ниже.

Да. Страница примеров — это живая демонстрационная площадка: каждое изображение там подгружается из API, пока вы смотрите, и вы сами можете сменить ракурс, перекрасить автомобиль и поменять фон. Если хотите увидеть это на своих машинах, пришлите несколько, и мы вернёмся с изображениями, обычно в тот же рабочий день.

Есть пакет на npm и MCP-сервер для ИИ-агентов. Ни то, ни другое не обязательно. Это HTTPS-эндпоинт, возвращающий адрес изображения, а с этим любая платформа уже умеет работать.

У большинства команд изображение появляется на странице в тот же день, когда они получают ключ, потому что интеграция — это адрес. Путь оттуда в продакшн обычно упирается в то, где кешировать, а не в объём кода.

100 марок и более 65 000 моделей, текущих и прошлых модельных лет. GET /api/brands в любой момент возвращает актуальный список для вашего ключа, так что верить цифре на маркетинговой странице не нужно. Посмотреть покрытие.

Прошлые поколения охвачены, и это важнее, чем принято думать: объявления о подержанных машинах, каталоги ремаркетинга и покупательские гиды в основном про автомобили, покинувшие салоны много лет назад. GET /api/{brand}/{model} перечисляет все доступные модельные годы для этой модели.

Нет. Фургоны, коммерческий транспорт, пикапы и мотоциклы рендерятся в том же студийном виде, поэтому смешанная страница автопарка по-прежнему читается как один каталог. Именно поэтому в сетке на странице примеров стоит мотоцикл.

API об этом сообщает, а не гадает, так что вы получаете ветвление в коде, а не чужой автомобиль на странице. Если запрошенного модельного года нет, он подставляет ближайшее доступное поколение и указывает это в errornotes.

Постоянно, по мере поступления данных от производителя. Для лизинга и конфигураторов это решающий момент: модель обычно есть в каталоге за месяцы до выпуска первого экземпляра, и именно тогда она нужна странице предложения.

Да, GET /api/getall одним ответом выгружает все конфигурации, доступные вашему ключу. Он намеренно объёмный и рассчитан на ночную синхронизацию, а не на загрузку страницы. Посмотреть эндпоинт.

Да, ключи можно ограничивать, и GET /api/me сообщает обо всех ограничениях в blocked_brands и year_range. Удобно, когда дилерский договор покрывает лишь часть рынка.

Девять ракурсов: восемь внешних (перед, корма, оба борта и четыре в три четверти) плюс снимки салона, например центральной консоли, если они у автомобиля есть. Каждый — отдельный запрос по той же конфигурации, в одинаковой студийной компоновке. Посмотреть все.

Да, и изменение перекрашивает настоящий студийный снимок, поэтому металлик по-прежнему читается как металлик. Пять фирменных цветов доступны на каждом автомобиле, сверху идут каталожные цвета конкретной марки, и есть плёнки 3M. GET /api/{...}/colors перечисляет, что предлагает конкретная машина. Посмотреть цвета.

Четыре опции, каждая — один параметр: shadow=true для студийной падающей тени, ground=true для контактной тени, чтобы автомобиль стоял на поверхности, mirroring=true для зеркального пола шоурума и transparency=true для чистой вырезки, которую можно поставить на что угодно. Посмотреть разницу.

PNG, WebP, JPEG и AVIF, шириной 200, 400, 800, 1200, 1600 или 2000 пикселей, с качеством от 40 до 100 (по умолчанию 82). Есть и именованные пресеты, от thumb (320 px) до full (2000 px), если не хочется выбирать числа.

По умолчанию 3:2. Запросите другое соотношение, и изображение дополняется полями, а не обрезается, поэтому от автомобиля никогда ничего не отрезается: 1:1, 4:3, 16:9, 16:10, 2:1, 21:9 и их вертикальные аналоги доступны все. Поэтому квадратная карточка и широкоформатный баннер могут использовать один и тот же автомобиль без дизайнера посередине.

Да, transparency=true возвращает вырезку с настоящим альфа-каналом. Стоит знать: прозрачность принудительно включает PNG, а PNG в несколько раз тяжелее того же автомобиля в WebP. Используйте его там, где альфа-канал действительно нужен, и WebP везде остальном.

На обычном тарифе нет. GET /api/me точно сообщает, что разрешает ваш ключ, в том числе принудительный водяной знак.

В этом и смысл рендера вместо съёмки. У каждого автомобиля одинаковое положение камеры, одинаковое расстояние и одинаковый свет, поэтому смешанная таблица сравнивает автомобили, а не фотографов. Именно поэтому сюда приходят команды автопарков и лизинга.

Это путь: /api/{brand}/{model}/{year}/{variant}/{trim}/{view}. GET по любому более короткому префиксу выдаёт следующий уровень, поэтому всё дерево обнаруживается простым обходом. Никакой схемы, которую надо выучить до первого запроса.

Да. VIN работает везде, поиск по госномеру зависит от рынка. Марка, модель, год и комплектация тоже определяются, а больше в форме объявления или в декларации автопарка часто и нет. Подробнее об определении.

У каждой конфигурации есть постоянный идентификатор. GET /api/id/{id} возвращает все доступные ракурсы, GET /api/id/{id}/{view} — один. Идентификаторы переживают обновления каталога и переименования, поэтому их можно спокойно записывать в собственную базу данных.

Да, и большинство интеграций так и делает. Скопируйте изображение в собственное хранилище и отдавайте оттуда, чтобы загрузка страницы никогда не зависела от обращения к нам. Подписанные адреса действуют семь дней, этого с запасом хватает, чтобы скачать и сохранить.

Он подставляет ближайшее допустимое значение и сообщает в errornotes, что именно сделал, вместо того чтобы упасть с ошибкой. Кодов 17, у каждого понятное словесное значение, так что их можно осознанно записывать в лог или игнорировать. Посмотреть коды.

Обычно намного меньше, чем кажется. Одинаковые конфигурации сводятся к одному рендеру, так что сорок одинаковых списанных фургонов — это одно переиспользованное изображение. Кешируйте у себя, и экран, показывающий одни и те же двадцать автомобилей каждому посетителю, стоит двадцать запросов всего, а не двадцать на посетителя.

Это обычный HTTPS-адрес, поэтому ваш загрузчик изображений и его дисковый кеш справятся без изменений, что в нативном коде, что в веб-вью. Запрашивайте ту ширину, которую действительно использует вёрстка, вместо того чтобы уменьшать печатное изображение на устройстве. Подробнее для мобильных команд.

Нет, и это сделано намеренно: каталог опрашивается, а не рассылается. Синхронизируйте его когда захотите через GET /api/getall или читайте список изменений, чтобы узнать, что вышло. На вашей стороне ничего поднимать не нужно.

Они отдаются из глобального периферийного кеша, поэтому первый байт приходит из точки рядом с посетителем, а не с сервера-источника. Вариант формируется один раз и дальше отдаётся из кеша.

Да. Страница состояния показывает доступность и время отклика в реальном времени, измеренные вне нашей собственной инфраструктуры. GET /api/status — машиночитаемая проверка доступности для вашего мониторинга.

Закешированные варианты до API вообще не доходят, и это обычная ситуация для страницы каталога, где все посетители видят одни и те же автомобили. Поэтому день запуска или кампании ведёт себя так же, как обычный вторник.

Ничего, если вы пошли обычным путём: один раз скопируйте изображение в собственное хранилище и отдавайте оттуда. Тогда ваша страница зависит от вашего CDN, а не от нашего. Это самое полезное, что стоит сделать пораньше.

Они отрендерены из данных об автомобилях, которые мы лицензируем. Это не фотографии, и они не собраны с дилерских сайтов или из пресс-китов. Именно поэтому мы можем зафиксировать разрешённые способы использования письменно, а с этого вопроса обычно и начинается разговор с юридическим отделом.

Да. Объявления, приложения, кампании, печать и клиентские документы покрыты, без указания источника и без водяного знака. Скажите, какие документы вы выпускаете, и это будет прямо прописано в лицензии.

Да, и для страховщиков и кредиторов обычно в этом и смысл: расчёты, условия полиса, договоры и переписка по убыткам. Как это чаще всего устроено, смотрите в разделах страхование и финансирование.

Нет. В кадре нет ни людей, ни узнаваемого места, а это снимает целый пласт работы с правами, который тянет за собой фотосъёмка.

Только идентификаторы автомобиля и ничего больше. VIN можно передать без полиса, заказа или клиента, к которому он относится, поэтому ничего личного покидать ваши системы не должно.

Оно показывает модель, комплектацию и заводской цвет из данных — именно так изображения производителя использовались всегда. Это не фотография конкретного экземпляра и не должна выдаваться за неё. Большинство площадок показывает её как репрезентативное изображение этой конфигурации, а реальные фото оставляет для галереи.

Показ изображений вашим пользователям покрыт по умолчанию. Разрешение пользователям скачивать или распространять файлы — это другое право, поэтому скажите, если оно нужно, и оно будет прямо прописано в лицензии, а не останется в подвешенном состоянии.

По уникальным конфигурациям, а не по просмотрам страниц, поэтому кривая стоимости выравнивается ровно там, где сосредоточен объём: модель, опубликованная тысячу раз, это не тысяча рендеров. Посмотреть тарифы.

Примерный набор моделей и сколько автомобилей вы публикуете или обслуживаете в месяц. Этого достаточно. Для прокатной компании это список классов, для кредитора — набор комплектаций, для портала — месячное число объявлений.

Нет. Брокер с несколькими предложениями в неделю и портал с миллионами объявлений получают одни и те же изображения и одни и те же опции.

GET /api/me отвечает на это одним вызовом: включённые функции, разрешённые форматы, разрешения, соотношения сторон, ракурсы, цвета и марки, а также любые ограничения и срок жизни подписанных URL. Посмотреть эндпоинт.

Нет. Конфигурация рендерится один раз, каждый последующий запрос той же комбинации отдаётся из кеша. Поэтому портал, публикующий одну модель тысячу раз, не платит тысячу раз.

Напишите нам или запишитесь на короткий разговор. Ответ обычно приходит в тот же рабочий день, и приходит от тех, кто всё это строит, а не из очереди тикетов.

Пришлите марку, модель и год. Добавить модель для нас обычная работа, а не одолжение, и это часто самый быстрый способ понять, пробел это в данных или расхождение в наименовании.

Спросите. Конкретный ракурс, вариант фона или формат выдачи, которого нет в списке, стоит обсуждения; часть того, что сегодня стандарт, началась с просьбы одного клиента.