# Imágenes

> Toda ruta de imagen de una respuesta de amodb se carga desde https://img.amodb.dev/t/p/{size}/{file}. Los tamaños coinciden con TMDB: w92, w154, w185, w300, w342, w500, w780, w1280, h632 y original. Las imágenes no necesitan clave y no cuentan en tu límite de solicitudes. La caché perimetral las guarda 30 días, y /3/configuration devuelve las URL base.

## Patrón de URL

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

`{file}` es la ruta de un campo de la respuesta como `poster_path`, `backdrop_path`, `profile_path`, `still_path` o `logo_path`. Ya empieza por `/`.

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

## Tamaños

| Tamaño     | Ancho o alto     | Ideal para                                            |
| ---------- | ---------------- | ----------------------------------------------------- |
| `w92`      | 92 px de ancho   | Sugerencias de búsqueda                               |
| `w154`     | 154 px de ancho  | Listas densas                                         |
| `w185`     | 185 px de ancho  | Cuadrículas en escritorio, fotos de perfil            |
| `w300`     | 300 px de ancho  | Miniaturas de backdrops, `Poster` de OMDb             |
| `w342`     | 342 px de ancho  | Cuadrículas en móviles con pantallas de alta densidad |
| `w500`     | 500 px de ancho  | Páginas de detalle                                    |
| `w780`     | 780 px de ancho  | Pósteres grandes, backdrops medianos                  |
| `w1280`    | 1280 px de ancho | Backdrops a todo el ancho                             |
| `h632`     | 632 px de alto   | Fotos de perfil a altura completa                     |
| `original` | Tamaño de origen | Descargas e impresión                                 |

Los pósteres son 2:3. Define `width` y `height` en el `<img>` para que la página no se desplace mientras carga.

## URL base desde el endpoint de configuración

`GET /3/configuration` devuelve la misma estructura que TMDB. Los clientes que construyen las URL de imágenes a partir de ella funcionan sin cambios.

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

La caché perimetral guarda `/3/configuration` durante 24 horas, así que basta con leerlo una vez al día.

## Imágenes adaptables

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

## Caché

Las imágenes permanecen en la caché perimetral 30 días. Guarda la ruta del archivo junto con tu registro y construye la URL al renderizar, así podrás cambiar de tamaño más adelante sin nuevas llamadas a la API.

## Preguntas y respuestas

### ¿Puedo poner las URL de imágenes directamente en etiquetas img?

Sí. Las URL de imágenes no llevan clave, así que son seguras en páginas públicas. Elige el tamaño más pequeño que cubra el ancho mostrado multiplicado por la densidad de píxeles del dispositivo.

### ¿Las solicitudes de imágenes cuentan para mi límite de solicitudes?

No. El host de imágenes no lee ninguna clave, así que los pósteres y backdrops nunca consumen tus solicitudes por minuto.

## Páginas relacionadas

- [Inicio rápido](https://amodb.dev/es/quickstart/): Haz tu primera llamada a amodb: consigue una clave, pide los detalles de una película en curl, JavaScript, Python, PHP o Go y carga el póster. En 2 minutos.
- [Idiomas](https://amodb.dev/es/languages/): amodb sirve títulos, sinopsis y nombres en 14 idiomas. Pasa una etiqueta estilo TMDB como ru-RU o pt-BR en language; cualquier otra etiqueta recurre al inglés.
- [Límites de solicitudes](https://amodb.dev/es/rate-limits/): amodb limita cada clave por solicitudes por minuto en una ventana deslizante de 60 segundos: 20, 40 o 120 según el plan. Lee los encabezados y gestiona el 429.

Actualizado: 2026-10-18. Source: https://amodb.dev/es/images/