Изображения

Каждый путь изображения в ответе amodb загружается с https://img.amodb.dev/t/p/{size}/{file}. Размеры те же, что в TMDB: w92, w154, w185, w300, w342, w500, w780, w1280, h632 и original. Изображениям ключ не нужен, и они не входят в ваш лимит запросов. Edge хранит их 30 дней, а базовые URL возвращает /3/configuration.

Обновлено Открыть в Markdown

Text
https://img.amodb.dev/t/p/{size}/{file}

Вместо {file} подставьте путь из поля ответа, например poster_path, backdrop_path, profile_path, still_path или logo_path. Он уже начинается с /.

Text
https://img.amodb.dev/t/p/w500/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg

Размеры

РазмерШирина или высотаДля чего подходит
w9292 px по ширинеПодсказки поиска
w154154 px по ширинеПлотные списки
w185185 px по ширинеСетки на десктопе, фото людей
w300300 px по ширинеМиниатюры фонов, Poster в OMDb
w342342 px по ширинеСетки на телефонах с экранами высокой плотности
w500500 px по ширинеСтраницы деталей
w780780 px по ширинеКрупные постеры, фоны среднего размера
w12801280 px по ширинеФоны на всю ширину
h632632 px по высотеФото людей в полную высоту
originalРазмер источникаЗагрузки и печать

Постеры имеют пропорции 2:3. Задайте width и height у <img>, чтобы страница не смещалась во время загрузки.

Базовые URL из эндпоинта конфигурации

GET /3/configuration возвращает ту же структуру, что и TMDB. Клиенты, которые строят URL изображений по ней, работают без изменений.

Edge хранит /3/configuration 24 часа, поэтому достаточно читать его раз в сутки.

JSON
{
  "images": {
    "base_url": "http://img.amodb.dev/t/p/",
    "secure_base_url": "https://img.amodb.dev/t/p/",
    "poster_sizes": ["w92", "w154", "w185", "w342", "w500", "w780", "original"]
  }
}
JavaScript
const base = "https://img.amodb.dev/t/p";
const srcset = ["w185", "w342", "w500"]
  .map((size) => `${base}/${size}${movie.poster_path} ${size.slice(1)}w`)
  .join(", ");

const html = `<img src="${base}/w342${movie.poster_path}" srcset="${srcset}"
  sizes="(min-width: 64rem) 185px, 33vw" width="342" height="513"
  alt="${movie.title} poster" loading="lazy">`;

Кэширование

Изображения остаются в кэше edge 30 дней. Храните путь к файлу вместе с записью и собирайте URL при отрисовке, чтобы позже менять размеры без новых вызовов API.

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

Можно ли вставлять URL изображений прямо в теги img?

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

Считаются ли запросы изображений в мой лимит запросов?

Нет. Хост изображений не читает ключ, поэтому постеры и фоны никогда не расходуют ваши запросы в минуту.