# Ключ API TMDB: сумісний ключ приблизно за хвилину

> Щоб отримати ключ API TMDB для комерційного проєкту, увійдіть в amodb за email і одноразовим кодом, оплатіть тариф і створіть ключ. Це займає близько хвилини. Ключ має формат TMDB v3, тож ви змінюєте базовий URL і зберігаєте свій код. Безкоштовного тарифу немає.

## Як отримати сумісний із TMDB ключ за чотири кроки

amodb продає ключі для власного API, яке зберігає шляхи й JSON TMDB v3. Це не ключ від TMDB, і він не працює на api.themoviedb.org. Ви отримуєте ключ тієї самої форми, 32 шістнадцяткові символи нижнього регістру, який ваш клієнт TMDB приймає після однієї зміни базового URL.

1. Відкрийте [сторінку цін](https://amodb.dev/uk/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/uk/authentication/), а ширший покроковий приклад у [швидкому старті](https://amodb.dev/uk/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 шістнадцяткові символи                                         | 32 шістнадцяткові символи нижнього регістру                                                                 |
| Базовий URL             | `https://api.themoviedb.org/3`                                             | `https://api.amodb.dev/3`                                                                                   |
| Методи запису           | Методи акаунта, списків і оцінок                                           | Не пропонуються, відповідають 405                                                                           |

## Коли достатньо безкоштовного ключа TMDB

Залишайтеся на безкоштовному ключі TMDB для особистого чи навчального проєкту, який вкладається в умови TMDB. Якщо ваш випадок підходить, TMDB нічого не коштує, і з цим amodb не зрівняється.

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

## Комерційне використання та ліміти

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

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

## Запитання й відповіді

### Це ключ API TMDB?

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

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