# TMDB API ключ: съвместим ключ за около минута

> За да вземете TMDB API ключ за търговски проект, влезте в amodb с имейл и еднократен код, платете плана и създайте ключа. Отнема около минута. Ключът има формата на TMDB v3, така че сменяте базовия URL адрес и запазвате кода си. Безплатен план няма.

## Ключ, съвместим с TMDB, в четири стъпки

amodb продава ключове за собственото си API, което запазва пътищата и JSON на TMDB v3. Това не е ключ от TMDB и не работи на api.themoviedb.org. Получавате ключ със същата форма, 32 шестнадесетични знака с малки букви, който клиентът ви за TMDB приема след една промяна на базовия URL адрес.

1. Отворете [страницата с цените](https://amodb.dev/bg/pricing/) и изберете план: 20, 40 или 120 заявки в минута. Всеки план връща всички данни.
2. Влезте с имейла си. 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/bg/authentication/), а по-подробно ръководство е в [бързия старт](https://amodb.dev/bg/quickstart/).

## Безплатен ключ за TMDB и ключ за amodb един до друг

Правилният избор зависи от проекта и условията ви, а не от списък с функции. Колоната за TMDB само повтаря онова, което TMDB публикува по принцип. Актуалните правила прочетете в собствените условия и документация на TMDB.

|                    | Безплатен ключ за TMDB                                                 | Ключ за amodb                                                                                                |
| ------------------ | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Цена               | Безплатно за допустимо ползване по условията на TMDB                   | Платен, предплатен за 1 до 24 месеца, без пробен период                                                      |
| Как го получавате  | Акаунт в TMDB и заявка за ключ на сайта на TMDB                        | Имейл, 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/bg/tmdb-api-alternative/) и в [amodb срещу TMDB](https://amodb.dev/bg/amodb-vs-tmdb/).

## Търговска употреба и лимити

Търговската употреба е разрешена според [условията](https://amodb.dev/bg/terms/) на amodb. Можете да показвате данните в приложения, сайтове, ботове и вътрешни инструменти и да кеширате отговори, за да спестявате заявки. Не можете да препродавате суров достъп до API, да публикувате масови дъмпове, да споделяте ключове или да отваряте допълнителни акаунти, за да вдигнете скоростта си. Пълният списък е в [политиката за допустимо използване](https://amodb.dev/bg/acceptable-use/).

Планът определя скоростта. Всеки отговор носи `X-RateLimit-Limit`, `X-RateLimit-Remaining` и `X-RateLimit-Reset`, а 429 добавя `Retry-After`. Подробности има в [лимитите на заявките](https://amodb.dev/bg/rate-limits/).

## Въпроси и отговори

### Това TMDB API ключ ли е?

Не. Това е ключ за amodb. Има същата форма като ключ за TMDB v3, 32 шестнадесетични знака с малки букви, и работи по пътищата на amodb, съвместими с TMDB v3, на https://api.amodb.dev/3. Не работи на api.themoviedb.org, а amodb е независима услуга.

### Мога ли да взема TMDB API ключ безплатно?

TMDB предлага безплатен ключ за допустимо ползване по собствените си условия и го искате от сайта на TMDB. amodb няма безплатен план и пробен период, затова ключът за amodb винаги идва с платен план. Прочетете условията на TMDB, преди да решите кое ви пасва.

### Мога ли да взема TMDB API ключ без регистрация?

Не в amodb. Влизате с имейл и 6-цифрен код, без парола и без формуляр за кандидатстване, после плащате и създавате ключа. За ключ на TMDB е нужен акаунт в TMDB, затова актуалните стъпки проверете на сайта на TMDB.

### Мога ли да ползвам ключа в търговски проект?

Да. Търговската употреба е разрешена според условията на amodb. Ползвайте данните в собствените си приложения и сайтове, но не препродавайте суров достъп до API, не споделяйте ключа си и не го слагайте в клиентски код.

### Колко заявки може да прави един ключ?

Планът определя скоростта: 20, 40 или 120 заявки в минута на ключ, броени в плъзгащ се прозорец от 60 секунди. Всеки план връща всички данни и няма дневен лимит.

## Свързани страници

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

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