Зображення

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

Оновлено Відкрити в 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

Розміри

РозмірШирина або висотаДля чого підходить
w92ширина 92 pxПідказки пошуку
w154ширина 154 pxЩільні списки
w185ширина 185 pxСітки на десктопі, фото профілів
w300ширина 300 pxМініатюри фонів, Poster в OMDb
w342ширина 342 pxСітки на телефонах з екранами високої щільності
w500ширина 500 pxСторінки деталей
w780ширина 780 pxВеликі постери, середні фони
w1280ширина 1280 pxФони на всю ширину
h632висота 632 pxФото профілів на повну висоту
originalПочатковий розмірЗавантаження та друк

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

Базові URL з ендпоінта конфігурації

GET /3/configuration повертає ту саму структуру, що й TMDB. Клієнти, які будують URL зображень із неї, працюють без змін.

Периферія зберігає /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">`;

Кешування

Зображення лишаються в кеші на периферії 30 днів. Зберігайте шлях до файлу разом із записом і будуйте URL під час відображення, щоб потім змінити розмір без нових викликів API.

Запитання та відповіді

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

Так. URL зображень не містять ключа, тож безпечні на публічних сторінках. Виберіть найменший розмір, який покриває ширину показу, помножену на щільність пікселів пристрою.

Чи входять запити зображень у мій ліміт запитів?

Ні. Хост зображень не читає ключ, тож постери та фони ніколи не витрачають ваші запити на хвилину.