# Документация amodb > Начните с быстрого старта, чтобы сделать первый вызов за две минуты. Затем прочитайте, как работают ключи, лимиты запросов, ошибки, языки и изображения. amodb сохраняет пути и JSON TMDB v3 и OMDb, поэтому большинство страниц объясняют, что совпадает, что добавляет amodb и в каких немногих местах он отличается. ## Базовые URL | Назначение | Базовый URL | Параметр ключа | | --------------- | ----------------------------------------- | ------------------------------------- | | В стиле TMDB v3 | `https://api.amodb.dev/3` | `api_key` или `Authorization: Bearer` | | В стиле OMDb | `https://api.amodb.dev/omdb/` | `apikey` | | Изображения | `https://img.amodb.dev/t/p/{size}/{file}` | нет | | Каталог тарифов | `https://api.amodb.dev/plans` | нет | ### Начало работы - [Быстрый старт](https://amodb.dev/ru/quickstart/): Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут. - [Аутентификация](https://amodb.dev/ru/authentication/): Как передать ключ amodb: api_key в запросе, заголовок Authorization Bearer или apikey для вызовов OMDb. Формат ключа, хранение, ротация и ошибки 401. ### Основные понятия - [Лимиты запросов](https://amodb.dev/ru/rate-limits/): amodb ограничивает ключ запросами в минуту в скользящем окне 60 секунд: 20, 40 или 120 по тарифу. Читайте заголовки лимита и обрабатывайте 429 с Retry-After. - [Ошибки](https://amodb.dev/ru/errors/): Все ошибки amodb: HTTP-статус, status_code и сообщение TMDB, а также формат ошибки OMDb. Что означает каждая и что должен делать ваш клиент дальше. - [Языки](https://amodb.dev/ru/languages/): amodb отдает названия, описания и имена на 14 языках. Передайте в language тег в стиле TMDB, например ru-RU или pt-BR; другие теги откатываются на английский. - [Изображения](https://amodb.dev/ru/images/): Загружайте постеры, фоны и фото людей с img.amodb.dev по путям и размерам TMDB от w92 до original. Без ключа, кэш на 30 дней, один шаблон URL для всех. ### Справочник API - [API деталей фильма](https://amodb.dev/ru/movies/): API деталей фильма с теми же путями и JSON, что в TMDB v3. Получите фильм по ID, добавьте актеров, рейтинги и настроения через append_to_response, на 14 языках. - [API сериалов](https://amodb.dev/ru/tv-series/): API сериалов с теми же путями и JSON, что в TMDB v3. Сериал по id с сезонами, телесетями и следующей серией, а также возрастные рейтинги и сервисы просмотра. - [API сезонов и серий сериала](https://amodb.dev/ru/tv-seasons-episodes/): API сезонов и серий сериала с теми же путями и JSON, что в TMDB v3. Читайте сезон со всеми сериями или одну серию с датой выхода, длительностью и кадром. - [API деталей человека](https://amodb.dev/ru/people/): API деталей человека с теми же путями и JSON, что в TMDB v3. Получайте актера или члена съемочной группы по ID: биография, фильмография, внешние ID, популярные. - [API актеров и съемочной группы](https://amodb.dev/ru/credits/): API credits с теми же путями и JSON, что в TMDB v3. Актерский состав и съемочная группа фильмов, сериалов, сезонов и серий с полями order, department, job. - [API поиска](https://amodb.dev/ru/search/): API поиска с путями и JSON как в TMDB v3. Находите фильмы, сериалы, людей, коллекции, компании и ключевые слова по тексту, с фильтром по году и пагинацией. - [Discover API](https://amodb.dev/ru/discover/): Discover API с фильтрами TMDB v3. Фильмы и сериалы по жанру, актеру, студии, ключевому слову, году, рейтингу, длительности и провайдеру, с сортировкой. - [Эндпоинты трендов и списков](https://amodb.dev/ru/trending-lists/): API фильмов в тренде с путями TMDB v3: чарты за день и неделю, а также списки идущих в кино, популярных, лучших и скорых фильмов и сериалов, кэш 30 минут. - [Жанры и справочники](https://amodb.dev/ru/genres/): API списка жанров с путями TMDB v3: ID жанров фильмов и сериалов с названиями, а также списки стран, языков, должностей, рейтингов и провайдеров. - [API изображений и хост изображений](https://amodb.dev/ru/images-api/): API изображений фильмов с путями TMDB v3: списки постеров, фонов, логотипов и кадров для каждого проекта, загрузка с img.amodb.dev в 10 размерах без ключа. - [API видео и трейлеров](https://amodb.dev/ru/videos-trailers/): API видео фильмов с путями TMDB v3: список трейлеров, тизеров, клипов и фичереток фильма или сериала, фильтрация по типу и языку в вашем коде. - [API переводов](https://amodb.dev/ru/translations/): API переводов фильмов с путями TMDB v3: читайте все сохраненные названия, описания и слоганы фильма, сериала или серии сразу на всех языках. - [API ключевых слов](https://amodb.dev/ru/keywords/): API ключевых слов фильмов с путями TMDB v3: теги сюжета фильма или сериала, поиск ключевого слова, его фильмы и объединение ID через discover with_keywords. - [API коллекций](https://amodb.dev/ru/collections/): API коллекций фильмов с путями TMDB v3: получите франшизу по ID со всеми частями, прочитайте belongs_to_collection у фильма и найдите коллекцию по названию. - [Компании и телесети](https://amodb.dev/ru/companies-networks/): Ищите киностудии и телесети по путям TMDB v3: читайте название, страну и логотип по ID, затем фильтруйте discover по ID компании или телесети. - [Рейтинги фильмов и сериалов](https://amodb.dev/ru/ratings/): API рейтингов фильмов: оценки IMDb, Kinopoisk, Metacritic, Rotten Tomatoes и TMDB для тайтла одним запросом, с null для источника, о котором нет данных. - [Поиск по внешнему ID](https://amodb.dev/ru/find-by-external-id/): Найдите фильм, сериал или персону по ID IMDb, TVDB, Wikidata или Kinopoisk через эндпоинт find TMDB, а также прочитайте внешние ID и факты Wikidata о проекте. - [Эндпоинт, совместимый с OMDb](https://amodb.dev/ru/omdb-endpoint/): Эндпоинт, совместимый с OMDb API, на api.amodb.dev/omdb/. Поиск по i или t, список через s, массив Ratings. Смените базовый URL, и клиент продолжит работать. - [Шкалы настроения](https://amodb.dev/ru/moods/): API настроений фильмов: шкалы от 0 до 10 для каждого тайтла. Читайте настроения фильма или сериала, добавляйте через append_to_response=moods, стройте бейджи. - [Саундтреки](https://amodb.dev/ru/soundtracks/): API саундтреков возвращает альбом саундтрека фильма или сериала со списком треков. Вызовите эндпоинт или добавьте append_to_response=soundtracks к деталям. - [Сеансы в кинотеатрах](https://amodb.dev/ru/showtimes/): API сеансов фильмов возвращает кинотеатры и время показов фильма в одной стране или сводку по странам. Добавляйте в детали фильма или сочетайте с now_playing. ### Ресурсы - [Журнал изменений](https://amodb.dev/ru/changelog/): Список изменений API amodb, хоста изображений img.amodb.dev, тарифов и сайта по датам. Новые записи сверху: что изменилось и что нужно сделать вам. - [Статус](https://amodb.dev/ru/status/): Как проверить, работает ли amodb: публичный эндпоинт health, коды ошибок, указывающие на сбой, и как сообщить о проблеме со всеми нужными нам подробностями. - [Справочник API](https://amodb.dev/ru/reference/): Все эндпоинты amodb с путем, параметрами, примерами запросов на пяти языках и настоящим ответом JSON. Совместимость с TMDB v3 и OMDb. - [Руководства](https://amodb.dev/ru/tutorials/): Пошаговые руководства по API amodb: поиск, детали, изображения, языки и вызовы OMDb в популярных стеках, с кодом, который можно скопировать и запустить. - [Сравнения amodb](https://amodb.dev/ru/compare/): Сравнения amodb с другими API метаданных фильмов и сериалов: совместимость, языки, лимиты, изображения и цены, с числами, которые можно проверить. - [Сценарии использования](https://amodb.dev/ru/use-cases/): Как команды применяют amodb для данных о фильмах и сериалах: каталоги, медиасерверы, рекомендации, боты и исследования, с нужными эндпоинтами и лимитами. ## Связанные страницы - [Быстрый старт](https://amodb.dev/ru/quickstart/): Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут. - [Аутентификация](https://amodb.dev/ru/authentication/): Как передать ключ amodb: api_key в запросе, заголовок Authorization Bearer или apikey для вызовов OMDb. Формат ключа, хранение, ротация и ошибки 401. - [Цены](https://amodb.dev/ru/pricing/): Тарифы amodb различаются только запросами в минуту: 20, 40 или 120. В каждом все данные в стиле TMDB v3 и OMDb. Предоплата, без продления и пробного периода. Обновлено: 2026-10-18. Source: https://amodb.dev/ru/docs/