# Зображення

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

## Шаблон URL

```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 зображень із неї, працюють без змін.

```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"]
  }
}
```

Периферія зберігає `/3/configuration` 24 години, тож достатньо читати його раз на день.

## Адаптивні зображення

```js
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 зображень не містять ключа, тож безпечні на публічних сторінках. Виберіть найменший розмір, який покриває ширину показу, помножену на щільність пікселів пристрою.

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

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

## Пов'язані сторінки

- [Швидкий старт](https://amodb.dev/uk/quickstart/): Перший виклик amodb: отримайте ключ, запросіть деталі фільму в curl, JavaScript, Python, PHP чи Go і завантажте постер з img.amodb.dev. Менш ніж за 2 хвилини.
- [Мови](https://amodb.dev/uk/languages/): amodb віддає назви, описи та імена 14 мовами. Передайте в language тег у стилі TMDB, наприклад ru-RU або pt-BR; будь-який інший тег переходить на англійську.
- [Ліміти запитів](https://amodb.dev/uk/rate-limits/): amodb обмежує кожен ключ запитами на хвилину в ковзному вікні 60 секунд: 20, 40 або 120 за тарифом. Читайте заголовки ліміту й обробляйте 429 із Retry-After.

Оновлено: 2026-10-18. Source: https://amodb.dev/uk/images/