# Изображения

> Каждый путь изображения в ответе 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.

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

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