# Выявы

> Кожны шлях да выявы ў адказе amodb загружаецца з https://img.amodb.dev/t/p/{size}/{file}. Памеры адпавядаюць TMDB: w92, w154, w185, w300, w342, w500, w780, w1280, h632 і original. Выявам ключ не патрэбны, і яны не ўлічваюцца ў вашым ліміце. Edge трымае іх 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"]
  }
}
```

Edge трымае `/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">`;
```

## Кэшаванне

Выявы застаюцца ў edge-кэшы 30 дзён. Захоўвайце шлях да файла разам са сваім запісам і будуйце URL пры адлюстраванні, каб потым змяніць памер без новых выклікаў API.

## Пытанні і адказы

### Ці можна ўстаўляць URL выяў наўпрост у тэгі img?

Так. URL выяў не нясуць ключа, таму іх бяспечна размяшчаць на публічных старонках. Выбірайце найменшы памер, які пакрывае шырыню на экране, памножаную на шчыльнасць пікселяў прылады.

### Ці ўлічваюцца запыты выяў у маім ліміце запытаў?

Не. Хост выяў не чытае ключ, таму постэры і фонавыя выявы ніколі не расходуюць вашы запыты ў хвіліну.

## Звязаныя старонкі

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

Абноўлена: 2026-10-18. Source: https://amodb.dev/be/images/