# Obrazy

> Każda ścieżka obrazu w odpowiedzi amodb ładuje się z https://img.amodb.dev/t/p/{size}/{file}. Rozmiary odpowiadają TMDB: w92, w154, w185, w300, w342, w500, w780, w1280, h632 i original. Obrazy nie wymagają klucza i nie liczą się do limitu. Edge trzyma je 30 dni, a /3/configuration zwraca bazowe adresy URL.

## Wzorzec URL

```text
https://img.amodb.dev/t/p/{size}/{file}
```

`{file}` to ścieżka z pola odpowiedzi, takiego jak `poster_path`, `backdrop_path`, `profile_path`, `still_path` lub `logo_path`. Już zaczyna się od `/`.

```text
https://img.amodb.dev/t/p/w500/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg
```

## Rozmiary

| Rozmiar    | Szerokość lub wysokość | Do czego                                         |
| ---------- | ---------------------- | ------------------------------------------------ |
| `w92`      | 92 px szerokości       | Podpowiedzi wyszukiwania                         |
| `w154`     | 154 px szerokości      | Gęste listy                                      |
| `w185`     | 185 px szerokości      | Siatki na desktopie, zdjęcia osób                |
| `w300`     | 300 px szerokości      | Miniatury teł, `Poster` z OMDb                   |
| `w342`     | 342 px szerokości      | Siatki na telefonach z ekranami o dużej gęstości |
| `w500`     | 500 px szerokości      | Strony szczegółów                                |
| `w780`     | 780 px szerokości      | Duże plakaty, średnie tła                        |
| `w1280`    | 1280 px szerokości     | Tła na całą szerokość                            |
| `h632`     | 632 px wysokości       | Zdjęcia osób w pełnej wysokości                  |
| `original` | Rozmiar źródła         | Pobieranie i druk                                |

Plakaty mają proporcje 2:3. Ustaw `width` i `height` na `<img>`, by strona nie przesuwała się podczas ładowania.

## Bazowe URL z endpointu konfiguracji

`GET /3/configuration` zwraca tę samą strukturę co TMDB. Klienty, które budują z niej adresy obrazów, działają bez zmian.

```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 trzyma `/3/configuration` przez 24 godziny, więc wystarczy odczytywać go raz dziennie.

## Obrazy responsywne

```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">`;
```

## Cache

Obrazy zostają w cache na edge przez 30 dni. Zapisuj ścieżkę pliku razem z rekordem i buduj URL przy renderowaniu, by móc później zmienić rozmiar bez nowych wywołań API.

## Pytania i odpowiedzi

### Czy mogę wstawiać adresy obrazów prosto do tagów img?

Tak. Adresy obrazów nie niosą klucza, więc są bezpieczne na stronach publicznych. Wybierz najmniejszy rozmiar, który pokrywa wyświetlaną szerokość pomnożoną przez zagęszczenie pikseli urządzenia.

### Czy żądania obrazów liczą się do limitu żądań?

Nie. Host obrazów nie czyta klucza, więc plakaty i tła nigdy nie zużywają twoich żądań na minutę.

## Powiązane strony

- [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut.
- [Języki](https://amodb.dev/pl/languages/): amodb serwuje tytuły, opisy i nazwy w 14 językach. Podaj tag w stylu TMDB, np. ru-RU lub pt-BR, w language; każdy inny tag wraca do angielskiego.
- [Limity żądań](https://amodb.dev/pl/rate-limits/): amodb limituje klucz liczbą żądań na minutę w przesuwanym oknie 60 sekund: 20, 40 lub 120 zależnie od planu. Czytaj nagłówki limitu i obsłuż 429 z Retry-After.

Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/images/