# Clave de API de TMDB: una clave compatible en alrededor de 1 minuto > Para conseguir una clave de API de TMDB en un proyecto comercial, inicia sesión en amodb con un correo y un código de un solo uso, paga un plan y crea la clave. Lleva alrededor de un minuto. La clave tiene la forma de TMDB v3, así que cambias la URL base y conservas tu código. No hay nivel gratuito. ## Consigue una clave compatible con TMDB en cuatro pasos amodb vende claves para su propia API, que conserva las rutas y el JSON de TMDB v3. No es una clave de TMDB y no funciona en api.themoviedb.org. Lo que recibes es una clave con la misma forma, 32 caracteres hexadecimales en minúscula, que tu cliente de TMDB acepta tras cambiar una sola vez la URL base. 1. Abre [precios](https://amodb.dev/es/pricing/) y elige un plan: 20, 40 o 120 solicitudes por minuto. Todos los planes devuelven todos los datos. 2. Inicia sesión con tu correo electrónico. amodb envía un código de 6 dígitos válido durante 10 minutos. No hay contraseña. 3. Paga con tarjeta, Apple Pay o Google Pay por un periodo de 1 a 24 meses. Nada se renueva automáticamente. 4. Abre **Cuenta**, luego **Claves de API**, y crea una clave. Cópiala de inmediato, porque la clave completa se muestra una sola vez. Los pasos llevan alrededor de un minuto, y la clave funciona en cuanto se confirma el pago. ## Usa la clave: cambia la URL base Conserva tu código de TMDB y cambia dos valores, la URL base y la clave. Valen las dos formas de enviar la clave, `api_key` en la consulta y un encabezado `Authorization: Bearer`. ```bash # TMDB curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY" # amodb curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY" ``` La misma llamada con un encabezado Bearer, en tres lenguajes: ```bash curl "https://api.amodb.dev/3/movie/550?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```js const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", { headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` }, }); if (!res.ok) throw new Error(`amodb ${res.status}`); const movie = await res.json(); console.log(movie.title, movie.release_date); ``` ```python import os import requests res = requests.get( "https://api.amodb.dev/3/movie/550", params={"language": "en-US"}, headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"}, timeout=10, ) res.raise_for_status() movie = res.json() print(movie["title"], movie["release_date"]) ``` La respuesta tiene la forma de TMDB v3: ```json { "id": 550, "imdb_id": "tt0137523", "title": "Fight Club", "release_date": "1999-10-15", "runtime": 139, "genres": [{ "id": 18, "name": "Drama" }], "vote_average": 8.4, "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg" } ``` Lee `images.secure_base_url` desde `/3/configuration` para que los enlaces de los pósteres apunten a `img.amodb.dev`. Las imágenes no necesitan clave. Encontrarás más detalles sobre cómo enviar la clave en [autenticación](https://amodb.dev/es/authentication/), y un recorrido más largo en el [inicio rápido](https://amodb.dev/es/quickstart/). ## Una clave gratuita de TMDB y una clave de amodb, lado a lado La elección correcta depende de tu proyecto y de tus condiciones, no de una lista de funciones. La columna de TMDB solo repite lo que TMDB publica de forma general. Lee las condiciones y la documentación de TMDB para ver las reglas vigentes. | | Clave gratuita de TMDB | Clave de amodb | | --------------------- | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | Precio | Gratis para usos que cumplan las condiciones de TMDB | De pago, prepago por 1 a 24 meses, sin prueba | | Cómo se consigue | Una cuenta de TMDB y una solicitud de clave en el sitio de TMDB | Correo, código de 6 dígitos, pago y luego crear la clave en tu cuenta | | Uso comercial | Consulta las condiciones de TMDB sobre uso comercial y atribución | Permitido por los términos de amodb | | Límite de solicitudes | Lo fija TMDB, consulta su documentación | 20, 40 o 120 solicitudes por minuto según el plan | | Datos | Datos de TMDB | Forma de TMDB v3, más `ratings`, `moods`, `soundtracks`, `wikidata` y `showtimes` mediante `append_to_response` | | Formato de la clave | Clave v3, 32 caracteres hexadecimales | 32 caracteres hexadecimales en minúscula | | URL base | `https://api.themoviedb.org/3` | `https://api.amodb.dev/3` | | Métodos de escritura | Métodos de cuenta, listas y puntuaciones | No se ofrecen, responden 405 | ## Cuándo basta una clave gratuita de TMDB Quédate con una clave gratuita de TMDB para un proyecto personal o de aprendizaje que encaje en las condiciones de TMDB. Si tu uso cumple los requisitos, TMDB no cuesta nada y amodb no puede igualarlo. Usa una clave de amodb cuando el proyecto sea comercial y quieras un acuerdo de pago, cuando necesites un límite fijo por minuto para poder planificar, o cuando la página de un título deba recibir puntuaciones de cinco fuentes en una sola llamada. Revisa antes las carencias: los métodos de escritura, los feeds de cambios y algunas otras rutas no se ofrecen. Están listados en [alternativa a la API de TMDB](https://amodb.dev/es/tmdb-api-alternative/) y en [amodb vs TMDB](https://amodb.dev/es/amodb-vs-tmdb/). ## Uso comercial y límites El uso comercial está permitido por los [términos](https://amodb.dev/es/terms/) de amodb. Puedes mostrar los datos en tus apps, sitios, bots y herramientas internas, y guardar respuestas en caché para ahorrar solicitudes. No puedes revender el acceso bruto a la API, publicar volcados masivos, compartir claves ni abrir cuentas adicionales para aumentar tu límite. La lista completa está en la [política de uso aceptable](https://amodb.dev/es/acceptable-use/). El plan fija el ritmo. Cada respuesta incluye `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset`, y un 429 añade `Retry-After`. Los detalles están en [límites de solicitudes](https://amodb.dev/es/rate-limits/). ## Preguntas y respuestas ### ¿Esta es una clave de API de TMDB? No. Es una clave de amodb. Tiene la misma forma que una clave v3 de TMDB, 32 caracteres hexadecimales en minúscula, y funciona en las rutas de amodb compatibles con TMDB v3 en https://api.amodb.dev/3. No funciona en api.themoviedb.org, y amodb es un servicio independiente. ### ¿Puedo conseguir una clave de API de TMDB gratis? TMDB ofrece una clave gratuita para usos que cumplan sus propias condiciones, y se pide en el sitio de TMDB. amodb no tiene nivel gratuito ni periodo de prueba, así que una clave de amodb siempre viene con un plan de pago. Lee las condiciones de TMDB antes de decidir cuál te conviene. ### ¿Puedo conseguir una clave de API de TMDB sin registrarme? En amodb no. Inicias sesión con un correo electrónico y un código de 6 dígitos, sin contraseña ni formulario de solicitud, y luego pagas y creas la clave. Una clave de TMDB requiere una cuenta de TMDB, así que consulta el sitio de TMDB para ver los pasos actuales. ### ¿Puedo usar la clave en un proyecto comercial? Sí. El uso comercial está permitido por los términos de amodb. Usa los datos en tus propias apps y sitios, pero no revendas el acceso bruto a la API, no compartas tu clave ni la pongas en código del lado del cliente. ### ¿Cuántas solicitudes puede hacer una clave? El plan fija el ritmo: 20, 40 o 120 solicitudes por minuto por clave, contadas en una ventana deslizante de 60 segundos. Todos los planes devuelven todos los datos y no hay tope diario. ## Páginas relacionadas - [Alternativa a la API de TMDB](https://amodb.dev/es/tmdb-api-alternative/): ¿Buscas una alternativa a TMDB? Revisa términos, límites, idiomas y puntuaciones, y pasa a una API de pago con la mayoría de lecturas y el JSON de TMDB v3. - [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. - [Precios](https://amodb.dev/es/pricing/): Los planes de amodb se diferencian solo en solicitudes por minuto: 20, 40 o 120. Todos incluyen todos los datos de TMDB v3 y OMDb. Prepago y sin renovación. - [Autenticación](https://amodb.dev/es/authentication/): Cómo enviar tu clave de amodb: api_key en la consulta, un encabezado Bearer o apikey en llamadas OMDb. Formato, almacenamiento, rotación y errores 401. - [amodb vs TMDB](https://amodb.dev/es/amodb-vs-tmdb/): Cara a cara entre amodb y TMDB: paridad de endpoints, rutas que amodb no ofrece, términos gratuitos y de pago, 14 idiomas, extensiones y límites de solicitudes. - [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-19. Source: https://amodb.dev/es/tmdb-api-key/