# Ключ API TMDB: совместимый ключ примерно за минуту

> Чтобы получить ключ API TMDB для коммерческого проекта, войдите в amodb по email и одноразовому коду, оплатите тариф и создайте ключ. Это занимает около минуты. Ключ имеет формат TMDB v3, поэтому вы меняете базовый URL и сохраняете свой код. Бесплатного тарифа нет.

## Как получить ключ, совместимый с TMDB, за четыре шага

amodb продает ключи для собственного API, которое сохраняет пути и JSON TMDB v3. Это не ключ от TMDB, и он не работает на api.themoviedb.org. Вы получаете ключ того же формата, 32 hex-символа в нижнем регистре, который принимает ваш клиент TMDB после одной смены базового URL.

1. Откройте [страницу цен](https://amodb.dev/ru/pricing/) и выберите тариф: 20, 40 или 120 запросов в минуту. Каждый тариф возвращает все данные.
2. Войдите по email. amodb отправляет 6-значный код, который действует 10 минут. Пароля нет.
3. Оплатите картой, через Apple Pay или Google Pay на срок от 1 до 24 месяцев. Автоматического продления нет.
4. Откройте **Аккаунт**, затем **Ключи API** и создайте ключ. Скопируйте его сразу, потому что полный ключ показывается один раз.

Все шаги занимают около минуты, а ключ начинает работать, как только платеж подтвержден.

## Использование ключа: смените базовый URL

Оставьте свой код для TMDB и измените два значения: базовый URL и ключ. Работают оба способа передачи ключа: `api_key` в запросе и заголовок `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"
```

Тот же вызов с заголовком Bearer на трех языках:

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

Ответ имеет формат 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"
}
```

Читайте `images.secure_base_url` из `/3/configuration`, чтобы ссылки на постеры указывали на `img.amodb.dev`. Изображениям ключ не нужен. Подробнее о передаче ключа на странице [аутентификация](https://amodb.dev/ru/authentication/), а более подробное руководство в [быстром старте](https://amodb.dev/ru/quickstart/).

## Бесплатный ключ TMDB и ключ amodb: сравнение

Правильный выбор зависит от вашего проекта и условий, а не от списка функций. Столбец TMDB лишь повторяет то, что TMDB публикует в общем виде. Актуальные правила смотрите в условиях и документации TMDB.

|                            | Бесплатный ключ TMDB                                                     | Ключ amodb                                                                                                  |
| -------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| Цена                       | Бесплатно для подходящего использования по условиям TMDB                 | Платно, предоплата на срок от 1 до 24 месяцев, без пробного периода                                         |
| Как получить               | Аккаунт TMDB и запрос ключа на сайте TMDB                                | Email, 6-значный код, оплата, затем создание ключа в аккаунте                                               |
| Коммерческое использование | Проверьте условия TMDB о коммерческом использовании и указании авторства | Разрешено условиями amodb                                                                                   |
| Лимит запросов             | Задает TMDB, смотрите их документацию                                    | 20, 40 или 120 запросов в минуту в зависимости от тарифа                                                    |
| Данные                     | Данные TMDB                                                              | Формат TMDB v3, плюс `ratings`, `moods`, `soundtracks`, `wikidata` и `showtimes` через `append_to_response` |
| Формат ключа               | Ключ v3, 32 hex-символа                                                  | 32 hex-символа в нижнем регистре                                                                            |
| Базовый URL                | `https://api.themoviedb.org/3`                                           | `https://api.amodb.dev/3`                                                                                   |
| Методы записи              | Методы аккаунта, списков и оценок                                        | Не предлагаются, отвечают 405                                                                               |

## Когда достаточно бесплатного ключа TMDB

Оставайтесь на бесплатном ключе TMDB для личного или учебного проекта, который укладывается в условия TMDB. Если ваш случай подходит, TMDB ничего не стоит, и с этим amodb не сравнится.

Выбирайте ключ amodb, когда проект коммерческий и вам нужно платное соглашение, когда нужен фиксированный лимит в минуту, под который можно планировать, или когда страница фильма должна получать рейтинги из пяти источников одним вызовом. Сначала проверьте, чего нет: методы записи, ленты changes и несколько других путей не предлагаются. Они перечислены на странице [альтернатива TMDB API](https://amodb.dev/ru/tmdb-api-alternative/) и в материале [amodb против TMDB](https://amodb.dev/ru/amodb-vs-tmdb/).

## Коммерческое использование и лимиты

Коммерческое использование разрешено [условиями](https://amodb.dev/ru/terms/) amodb. Вы можете показывать данные в своих приложениях, на сайтах, в ботах и внутренних инструментах, а также кэшировать ответы, чтобы экономить запросы. Нельзя перепродавать сырой доступ к API, публиковать массовые выгрузки, делиться ключами и открывать дополнительные аккаунты, чтобы повысить лимит. Полный список приведен в [правилах допустимого использования](https://amodb.dev/ru/acceptable-use/).

Лимит задает тариф. Каждый ответ содержит `X-RateLimit-Limit`, `X-RateLimit-Remaining` и `X-RateLimit-Reset`, а ответ 429 добавляет `Retry-After`. Подробности на странице [лимиты запросов](https://amodb.dev/ru/rate-limits/).

## Вопросы и ответы

### Это ключ API TMDB?

Нет. Это ключ amodb. Он имеет тот же формат, что и ключ TMDB v3, 32 hex-символа в нижнем регистре, и работает на путях amodb, совместимых с TMDB v3, по адресу https://api.amodb.dev/3. На api.themoviedb.org он не работает, а amodb является независимым сервисом.

### Можно ли получить ключ API TMDB бесплатно?

TMDB предлагает бесплатный ключ для подходящего использования по своим условиям, и запрашивается он на сайте TMDB. У amodb нет бесплатного тарифа и пробного периода, поэтому ключ amodb всегда идет с платным тарифом. Прочитайте условия TMDB, прежде чем решать, что вам подходит.

### Можно ли получить ключ API TMDB без регистрации?

Не в amodb. Вы входите по email и 6-значному коду, без пароля и без формы заявки, затем оплачиваете и создаете ключ. Для ключа TMDB нужен аккаунт TMDB, поэтому актуальные шаги смотрите на сайте TMDB.

### Можно ли использовать ключ в коммерческом проекте?

Да. Коммерческое использование разрешено условиями amodb. Используйте данные в своих приложениях и на сайтах, но не перепродавайте сырой доступ к API, не делитесь ключом и не размещайте его в клиентском коде.

### Сколько запросов может делать один ключ?

Лимит задает тариф: 20, 40 или 120 запросов в минуту на ключ, в скользящем окне 60 секунд. Каждый тариф возвращает все данные, суточного лимита нет.

## Связанные страницы

- [Альтернатива TMDB API](https://amodb.dev/ru/tmdb-api-alternative/): Нужна альтернатива TMDB API? Сверьте условия, лимиты, языки и рейтинги, затем перейдите на платный API, где работает большинство путей чтения и JSON TMDB v3.
- [Быстрый старт](https://amodb.dev/ru/quickstart/): Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут.
- [Цены](https://amodb.dev/ru/pricing/): Тарифы amodb различаются только запросами в минуту: 20, 40 или 120. В каждом все данные в стиле TMDB v3 и OMDb. Предоплата, без продления и пробного периода.
- [Аутентификация](https://amodb.dev/ru/authentication/): Как передать ключ amodb: api_key в запросе, заголовок Authorization Bearer или apikey для вызовов OMDb. Формат ключа, хранение, ротация и ошибки 401.
- [amodb против TMDB](https://amodb.dev/ru/amodb-vs-tmdb/): Сравнение amodb и TMDB: совместимость эндпоинтов, пути, которых нет в amodb, бесплатные и платные условия, 14 языков, расширения и лимиты запросов.
- [Лимиты запросов](https://amodb.dev/ru/rate-limits/): amodb ограничивает ключ запросами в минуту в скользящем окне 60 секунд: 20, 40 или 120 по тарифу. Читайте заголовки лимита и обрабатывайте 429 с Retry-After.

Обновлено: 2026-10-19. Source: https://amodb.dev/ru/tmdb-api-key/