# Immagini

> Ogni percorso di immagine in una risposta di amodb si carica da https://img.amodb.dev/t/p/{size}/{file}. Le dimensioni corrispondono a TMDB: w92, w154, w185, w300, w342, w500, w780, w1280, h632 e original. Le immagini non richiedono chiave e non contano nella tua frequenza. L'edge le tiene 30 giorni e /3/configuration restituisce gli URL di base.

## Schema dell'URL

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

`{file}` è il percorso preso da un campo della risposta come `poster_path`, `backdrop_path`, `profile_path`, `still_path` o `logo_path`. Inizia già con `/`.

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

## Dimensioni

| Dimensione | Larghezza o altezza  | Adatta per                                      |
| ---------- | -------------------- | ----------------------------------------------- |
| `w92`      | 92 px di larghezza   | Suggerimenti di ricerca                         |
| `w154`     | 154 px di larghezza  | Elenchi fitti                                   |
| `w185`     | 185 px di larghezza  | Griglie su desktop, foto dei profili            |
| `w300`     | 300 px di larghezza  | Miniature degli sfondi, `Poster` di OMDb        |
| `w342`     | 342 px di larghezza  | Griglie su telefoni con schermi ad alta densità |
| `w500`     | 500 px di larghezza  | Pagine di dettaglio                             |
| `w780`     | 780 px di larghezza  | Locandine grandi, sfondi medi                   |
| `w1280`    | 1280 px di larghezza | Sfondi a tutta larghezza                        |
| `h632`     | 632 px di altezza    | Foto dei profili a tutta altezza                |
| `original` | Dimensione originale | Download e stampa                               |

Le locandine sono 2:3. Imposta `width` e `height` su `<img>` perché la pagina non si sposti durante il caricamento.

## URL di base dall'endpoint di configurazione

`GET /3/configuration` restituisce la stessa struttura di TMDB. I client che costruiscono da lì gli URL delle immagini funzionano senza modifiche.

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

L'edge tiene `/3/configuration` per 24 ore, quindi leggerlo una volta al giorno basta.

## Immagini responsive

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

Le immagini restano nella cache edge per 30 giorni. Salva il percorso del file insieme al tuo record e costruisci l'URL quando lo mostri, così puoi cambiare dimensione in seguito senza nuove chiamate all'API.

## Domande e risposte

### Posso mettere gli URL delle immagini direttamente nei tag img?

Sì. Gli URL delle immagini non contengono chiavi, quindi sono sicuri nelle pagine pubbliche. Scegli la dimensione più piccola che copre la larghezza mostrata moltiplicata per il rapporto di pixel del dispositivo.

### Le richieste di immagini contano nel mio limite di richieste?

No. L'host delle immagini non legge alcuna chiave, quindi locandine e sfondi non usano mai le tue richieste al minuto.

## Pagine correlate

- [Avvio rapido](https://amodb.dev/it/quickstart/): Fai la prima chiamata ad amodb: ottieni una chiave, richiedi i dettagli di un film in curl, JavaScript, Python, PHP o Go, carica la locandina. Meno di 2 minuti.
- [Lingue](https://amodb.dev/it/languages/): amodb serve titoli, trame e nomi in 14 lingue. Passa un tag in stile TMDB come ru-RU o pt-BR in language; qualsiasi altro tag ripiega sull'inglese.
- [Limiti di richieste](https://amodb.dev/it/rate-limits/): amodb limita ogni chiave per richieste al minuto in una finestra scorrevole di 60 secondi: 20, 40 o 120 in base al piano. Leggi gli header, gestisci il 429.

Aggiornato: 2026-10-18. Source: https://amodb.dev/it/images/