# Ключ 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/be/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/be/authentication/), а падрабязнае пакрокавае кіраўніцтва ў [хуткім старце](https://amodb.dev/be/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/be/tmdb-api-alternative/) і ў матэрыяле [amodb супраць TMDB](https://amodb.dev/be/amodb-vs-tmdb/).

## Камерцыйнае выкарыстанне і ліміты

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

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

Абноўлена: 2026-10-19. Source: https://amodb.dev/be/tmdb-api-key/