Как получить ключ, совместимый с TMDB, за четыре шага
amodb продает ключи для собственного API, которое сохраняет пути и JSON TMDB v3. Это не ключ от TMDB, и он не работает на api.themoviedb.org. Вы получаете ключ того же формата, 32 hex-символа в нижнем регистре, который принимает ваш клиент TMDB после одной смены базового URL.
- Откройте страницу цен и выберите тариф: 20, 40 или 120 запросов в минуту. Каждый тариф возвращает все данные.
- Войдите по email. amodb отправляет 6-значный код, который действует 10 минут. Пароля нет.
- Оплатите картой, через Apple Pay или Google Pay на срок от 1 до 24 месяцев. Автоматического продления нет.
- Откройте Аккаунт, затем Ключи API и создайте ключ. Скопируйте его сразу, потому что полный ключ показывается один раз.
Все шаги занимают около минуты, а ключ начинает работать, как только платеж подтвержден.
Использование ключа: смените базовый URL
Оставьте свой код для TMDB и измените два значения: базовый URL и ключ. Работают оба способа передачи ключа: api_key в запросе и заголовок Authorization: Bearer.
# 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 на трех языках:
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
-H "Authorization: Bearer $AMODB_KEY"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);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:
{
"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. Изображениям ключ не нужен. Подробнее о передаче ключа на странице аутентификация, а более подробное руководство в быстром старте.
Бесплатный ключ 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:/ | https:/ |
| Методы записи | Методы аккаунта, списков и оценок | Не предлагаются, отвечают 405 |
Когда достаточно бесплатного ключа TMDB
Оставайтесь на бесплатном ключе TMDB для личного или учебного проекта, который укладывается в условия TMDB. Если ваш случай подходит, TMDB ничего не стоит, и с этим amodb не сравнится.
Выбирайте ключ amodb, когда проект коммерческий и вам нужно платное соглашение, когда нужен фиксированный лимит в минуту, под который можно планировать, или когда страница фильма должна получать рейтинги из пяти источников одним вызовом. Сначала проверьте, чего нет: методы записи, ленты changes и несколько других путей не предлагаются. Они перечислены на странице альтернатива TMDB API и в материале amodb против TMDB.
Коммерческое использование и лимиты
Коммерческое использование разрешено условиями amodb. Вы можете показывать данные в своих приложениях, на сайтах, в ботах и внутренних инструментах, а также кэшировать ответы, чтобы экономить запросы. Нельзя перепродавать сырой доступ к API, публиковать массовые выгрузки, делиться ключами и открывать дополнительные аккаунты, чтобы повысить лимит. Полный список приведен в правилах допустимого использования.
Лимит задает тариф. Каждый ответ содержит X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, а ответ 429 добавляет Retry-After. Подробности на странице лимиты запросов.