# Images

> Chaque chemin d'image d'une réponse amodb se charge depuis https://img.amodb.dev/t/p/{size}/{file}. Les tailles suivent TMDB : w92, w154, w185, w300, w342, w500, w780, w1280, h632 et original. Les images n'exigent aucune clé et ne comptent pas dans votre débit. Le cache de périphérie les garde 30 jours, et /3/configuration renvoie les URL de base.

## Modèle d'URL

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

`{file}` est le chemin d'un champ de réponse comme `poster_path`, `backdrop_path`, `profile_path`, `still_path` ou `logo_path`. Il commence déjà par `/`.

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

## Tailles

| Taille     | Largeur ou hauteur | Convient pour                                |
| ---------- | ------------------ | -------------------------------------------- |
| `w92`      | 92 px de large     | Suggestions de recherche                     |
| `w154`     | 154 px de large    | Listes denses                                |
| `w185`     | 185 px de large    | Grilles sur ordinateur, photos de profil     |
| `w300`     | 300 px de large    | Miniatures de fonds, `Poster` OMDb           |
| `w342`     | 342 px de large    | Grilles sur téléphones à écran haute densité |
| `w500`     | 500 px de large    | Pages de détails                             |
| `w780`     | 780 px de large    | Grandes affiches, fonds moyens               |
| `w1280`    | 1280 px de large   | Fonds en pleine largeur                      |
| `h632`     | 632 px de haut     | Photos de profil en pleine hauteur           |
| `original` | Taille d'origine   | Téléchargements et impression                |

Les affiches sont en 2:3. Définissez `width` et `height` sur la balise `<img>` pour que la page ne bouge pas pendant le chargement.

## URL de base depuis le point de terminaison de configuration

`GET /3/configuration` renvoie la même structure que TMDB. Les clients qui construisent les URL d'images à partir de cette réponse fonctionnent sans changement.

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

Le cache de périphérie garde `/3/configuration` pendant 24 heures : une lecture par jour suffit.

## Images adaptatives

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

## Mise en cache

Les images restent 30 jours dans le cache de périphérie. Stockez le chemin du fichier avec votre fiche et construisez l'URL au moment de l'affichage : vous pourrez changer de taille plus tard sans nouvel appel d'API.

## Questions et réponses

### Puis-je mettre des URL d'images directement dans des balises img ?

Oui. Les URL d'images ne portent aucune clé : elles sont sûres dans des pages publiques. Choisissez la plus petite taille qui couvre la largeur affichée multipliée par le ratio de pixels de l'appareil.

### Les requêtes d'images comptent-elles dans ma limite de débit ?

Non. L'hôte d'images ne lit aucune clé : affiches et fonds n'utilisent donc jamais vos requêtes par minute.

## Pages liées

- [Démarrage rapide](https://amodb.dev/fr/quickstart/): Faites votre premier appel amodb : obtenez une clé, demandez un film en curl, JavaScript, Python, PHP ou Go, puis chargez l'affiche. En moins de 2 minutes.
- [Langues](https://amodb.dev/fr/languages/): amodb sert titres, résumés et noms en 14 langues. Passez une balise TMDB comme ru-RU ou pt-BR dans language ; toute autre balise se replie sur l'anglais.
- [Limites de débit](https://amodb.dev/fr/rate-limits/): amodb limite chaque clé en requêtes par minute sur une fenêtre glissante de 60 secondes : 20, 40 ou 120 selon l'offre. Lisez les en-têtes et gérez le 429.

Mis à jour: 2026-10-18. Source: https://amodb.dev/fr/images/