# Imagini

> Orice cale de imagine dintr-un răspuns amodb se încarcă de la https://img.amodb.dev/t/p/{size}/{file}. Dimensiunile sunt cele din TMDB: w92, w154, w185, w300, w342, w500, w780, w1280, h632 și original. Imaginile nu cer cheie și nu intră în rata ta. Marginea le ține 30 de zile, iar /3/configuration întoarce URL-urile de bază.

## Modelul de URL

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

`{file}` este calea dintr-un câmp de răspuns precum `poster_path`, `backdrop_path`, `profile_path`, `still_path` sau `logo_path`. Începe deja cu `/`.

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

## Dimensiuni

| Dimensiune | Lățime sau înălțime | Potrivită pentru                                  |
| ---------- | ------------------- | ------------------------------------------------- |
| `w92`      | 92 px lățime        | Sugestii de căutare                               |
| `w154`     | 154 px lățime       | Liste dense                                       |
| `w185`     | 185 px lățime       | Grile pe desktop, fotografii de profil            |
| `w300`     | 300 px lățime       | Miniaturi de imagini de fundal, `Poster` din OMDb |
| `w342`     | 342 px lățime       | Grile pe telefoane cu ecrane de densitate mare    |
| `w500`     | 500 px lățime       | Pagini de detalii                                 |
| `w780`     | 780 px lățime       | Postere mari, imagini de fundal medii             |
| `w1280`    | 1280 px lățime      | Imagini de fundal pe toată lățimea                |
| `h632`     | 632 px înălțime     | Fotografii de profil pe toată înălțimea           |
| `original` | Dimensiunea sursei  | Descărcări și tipar                               |

Posterele au raportul 2:3. Setează `width` și `height` pe `<img>` ca pagina să nu se deplaseze în timpul încărcării.

## URL-uri de bază din endpoint-ul de configurare

`GET /3/configuration` întoarce aceeași structură ca TMDB. Clienții care construiesc URL-uri de imagini din el funcționează fără modificări.

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

Marginea ține `/3/configuration` 24 de ore, deci este de ajuns să-l citești o dată pe zi.

## Imagini adaptive

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

Imaginile rămân în cache la margine 30 de zile. Stochează calea fișierului împreună cu înregistrarea și construiește URL-ul la afișare, ca să poți schimba dimensiunile mai târziu fără apeluri noi la API.

## Întrebări și răspunsuri

### Pot pune URL-urile de imagini direct în tag-uri img?

Da. URL-urile de imagini nu conțin cheie, deci sunt sigure în paginile publice. Alege cea mai mică dimensiune care acoperă lățimea afișată înmulțită cu raportul de pixeli al dispozitivului.

### Cererile de imagini intră în limita mea de cereri?

Nu. Gazda de imagini nu citește nicio cheie, deci posterele și imaginile de fundal nu consumă niciodată cererile tale pe minut.

## Pagini conexe

- [Ghid rapid](https://amodb.dev/ro/quickstart/): Fă primul apel amodb: ia o cheie, cere detaliile unui film în curl, JavaScript, Python, PHP sau Go, apoi încarcă posterul de pe img.amodb.dev. Sub 2 minute.
- [Limbi](https://amodb.dev/ro/languages/): amodb servește titluri, descrieri și nume în 14 limbi. Trimite în language o etichetă în stil TMDB, precum ru-RU sau pt-BR; altă etichetă revine la engleză.
- [Limite de cereri](https://amodb.dev/ro/rate-limits/): amodb limitează fiecare cheie în cereri pe minut, în fereastră glisantă de 60 de secunde: 20, 40 sau 120. Citește antetele și tratează 429 cu Retry-After.

Actualizat: 2026-10-18. Source: https://amodb.dev/ro/images/