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

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

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