# Alternatywa dla API TMDB > Szukaj alternatywy dla API TMDB, gdy chcesz płatnej umowy, limitu żądań, pod który da się planować, albo więcej danych w każdej odpowiedzi. amodb mówi protokołem TMDB v3 w odczycie, więc zmieniasz bazowy URL i klucz. Zapisy i kilka ścieżek nie są dostępne. Zostań przy TMDB, jeśli jego darmowe warunki ci odpowiadają. ## Które API wybrać TMDB oferuje darmowe API dla kwalifikowanego użycia według własnych warunków, z kluczami API v3 i tokenami v4. Zanim wdrożysz produkt, przeczytaj te warunki użycia komercyjnego i atrybucji. Wybierz alternatywę, gdy chcesz płatnej umowy, limitu, pod który da się planować, albo więcej danych w każdej odpowiedzi. amodb to niezależne API mówiące protokołem TMDB v3 w odczycie, więc przejście oznacza nowy bazowy URL i nowy klucz. Jest tylko do odczytu, a kilka ścieżek TMDB nie jest dostępnych, jak wymieniono niżej. Zostań przy TMDB, jeśli darmowe warunki pasują do twojego projektu i nic z następnej sekcji cię nie dotyczy. ## Sygnały, że potrzebujesz alternatywy Pięć kontroli pomaga zdecydować. Uruchom je na własnym ruchu i własnej umowie, a nie na liście funkcji. | Sygnał | Co sprawdzić | Jak odpowiada amodb | | ------------------ | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | Warunki komercyjne | Przeczytaj warunki API, którego używasz dziś, pod kątem użycia komercyjnego i atrybucji | Płatne plany, przedpłacone, bez automatycznego odnawiania | | Szczytowy ruch | Policz żądania w najbardziej obciążonej minucie | Stały limit 20, 40 lub 120 żądań na minutę na klucz | | Dane na ekran | Wypisz dodatkowe wywołania za stroną jednego tytułu | `append_to_response` przyjmuje też `ratings`, `moods`, `soundtracks`, `wikidata` i `showtimes` | | Język interfejsu | Sprawdź każdy język, który dostarczasz | 14 języków, wszystko inne wraca do `en` | | Koszt wyjścia | Policz linie kodu, które nazywają dostawcę | Te same ścieżki i JSON na udostępnianych endpointach, więc wyjście to też tylko zmiana bazowego URL | Trafienia w cache też się liczą. Sprawdzenie klucza i limitu działa przed cache na edge, więc powtórzone żądanie nadal zużywa jedno z twoich żądań na minutę. Planuj według łącznej liczby żądań, a nie chybień cache. ## Porównanie funkcji | Funkcja | TMDB | amodb | | ----------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------- | | Model cenowy | Darmowe API dla kwalifikowanego użycia według własnych warunków | Okresy przedpłacone 1, 3, 6, 12 lub 24 miesiące | | Darmowy plan | Tak, dla kwalifikowanego użycia | Brak, ani wersji próbnej | | Uwierzytelnianie | Klucz v3 w `api_key` albo token v4 jako Bearer | `api_key` lub Bearer, klucz z 32 znaków szesnastkowych | | Format odpowiedzi | JSON | JSON w kształcie TMDB v3 | | Języki | Sprawdź ich dokumentację | 14 języków interfejsu | | Filmy | Tak | Tak | | Seriale | Tak | Tak, z sezonami i odcinkami | | Osoby | Tak | Tak | | Obrazy | Tak, z własnego hosta obrazów | `img.amodb.dev`, te same tokeny rozmiarów, bez klucza | | Oceny | Ocena użytkowników TMDB, inne źródła sprawdź w ich dokumentacji | Wynik TMDB plus IMDb, Kinopoisk, Metacritic i Rotten Tomatoes, gdy znane | | Metody zapisu | Metody konta, list i ocen | Niedostępne, odpowiadają 405 | | Limit żądań | Sprawdź ich dokumentację | 20, 40 lub 120 na minutę na klucz | | Użycie komercyjne | Sprawdź ich warunki użycia komercyjnego i atrybucji | Sprzedawane jako płatne API, zobacz [cennik](https://amodb.dev/pl/pricing/) | | Zgodność | Definiuje protokół v3 | Większość ścieżek odczytu v3 plus OMDb | ## Czym amodb się różni - **Limity, które możesz odczytać.** Każda odpowiedź z kluczem niesie `X-RateLimit-Limit`, `X-RateLimit-Remaining` i `X-RateLimit-Reset` w sekundach. 429 dodaje `Retry-After`. Liczby wyjaśnia strona [limity żądań](https://amodb.dev/pl/rate-limits/). - **Dodatkowe bloki w jednym wywołaniu.** Oceny z pięciu źródeł, mierniki nastroju, ścieżki dźwiękowe, fakty z Wikidata i seanse kinowe przychodzą przez `append_to_response`, więc strona jednego tytułu może użyć jednego żądania. - **Więcej źródeł zewnętrznych ID.** `/3/find` rozwiązuje `imdb_id`, `tvdb_id`, `wikidata_id` i `kinopoisk_id`, a także `facebook_id`, `twitter_id` i `instagram_id`. Zobacz [wyszukiwanie po zewnętrznym ID](https://amodb.dev/pl/find-by-external-id/). - **OMDb na tym samym kluczu.** `https://api.amodb.dev/omdb/` odpowiada na wywołania w stylu OMDb z parametrem `apikey`, co pomaga, gdy dwa twoje systemy używają różnych protokołów. - **Znane czasy cache.** Szczegóły i obsada zostają 6 godzin na edge, trending i discover 30 minut, wyszukiwanie 10 minut, konfiguracja 24 godziny, a obrazy 30 dni. ## Kiedy TMDB pasuje lepiej - **Darmowe projekty.** Jeśli twoje użycie spełnia darmowe warunki, TMDB nic nie kosztuje i amodb nie może tego dorównać. - **Użytkownikowe metody zapisu.** TMDB oferuje metody zapisu konta, sesji, ocen i list. amodb odpowiada na nie 405 i status_code 37, więc aplikacja, która pozwala ludziom logować się i oceniać tytuły, powinna zostawić TMDB dla tej części. - **Kanały zmian.** TMDB wymienia ID, które się zmieniły. amodb nie ma takiego kanału, więc odświeżasz według własnego harmonogramu. - **Języki poza 14.** amodb nie udostępnia tekstu interfejsu po niemiecku, japońsku ani koreańsku i wraca do angielskiego. Tytuły oryginalne nadal przychodzą w `original_title` i `original_name`. Inne języki w TMDB sprawdź w ich dokumentacji. - **Warunki, które już zostały zaakceptowane.** Jeśli przegląd prawny dla TMDB jest zrobiony, przejście kosztuje cię kolejny przegląd. ## Czego amodb nie udostępnia Przed przełączeniem sprawdź swój kod z tą listą. Pełna tabela jest na stronie [amodb vs TMDB](https://amodb.dev/pl/amodb-vs-tmdb/). | Wywołanie TMDB | Odpowiedź amodb | | ------------------------------------------------------------------------------------------ | --------------------------------- | | Zapisy konta, sesji, ocen i list | 405, `status_code` 37 | | Changes, aggregate credits, wyszukiwanie wpisów obsady i recenzji, zawartość grup odcinków | 404, `status_code` 34 | | Tłumaczenia osób, obrazy i tłumaczenia kolekcji, firm i sieci | 404, `status_code` 34 | | Lista recenzji filmu lub serialu | 200, pusta dla większości tytułów | | Obrazy, wideo i tłumaczenia sezonów | 200, puste | | Zewnętrzne ID sezonów i odcinków | 200, wszystkie null | Dwa zachowania są ciche. Nazwa w `append_to_response`, której amodb nie zna, na przykład `aggregate_credits`, jest ignorowana bez błędu. Parametr `include_adult` też jest ignorowany, bo tytuły i osoby dla dorosłych nigdy nie są udostępniane. ## Przejście na amodb 1. Wybierz plan na stronie [cennik](https://amodb.dev/pl/pricing/) i utwórz klucz w panelu konta. 2. Zamień bazowy URL i klucz w jednym miejscu, jak niżej. 3. Odczytaj `images.secure_base_url` z `/3/configuration`, aby linki do obrazów używały `img.amodb.dev`. 4. Usuń wywołania metod zapisu i ścieżek z powyższej tabeli. 5. Obsłuż 429, czekając `Retry-After` sekund. ```js const config = { // before: baseUrl held your current TMDB v3 base URL baseUrl: 'https://api.amodb.dev/3', apiKey: process.env.AMODB_KEY, }; const res = await fetch(`${config.baseUrl}/movie/550?language=en-US`, { headers: { Authorization: `Bearer ${config.apiKey}` }, }); if (!res.ok) throw new Error(`request failed with status ${res.status}`); const movie = await res.json(); console.log(movie.title, movie.release_date); ``` Przed przełączeniem uruchom istniejące testy na obu bazowych URL. Wspólny kształt nie gwarantuje identycznych wartości, więc porównaj próbkę własnych tytułów. Pełny przewodnik jest w [szybkim starcie](https://amodb.dev/pl/quickstart/), a tabela obok siebie na stronie [amodb vs TMDB](https://amodb.dev/pl/amodb-vs-tmdb/). ### Obsługa błędów się przenosi Nieudane wywołania zwracają treść TMDB `{"success": false, "status_code": N, "status_message": "..."}`, więc kod rozgałęziający po `status_code` nie wymaga przepisania. | HTTP | status_code | Typowa przyczyna | | ---- | ----------- | ----------------------------------------------------------- | | 401 | 7 | Brak klucza lub literówka | | 401 | 10 | Klucz zawieszony | | 402 | 36 | Okres przedpłaty dobiegł końca | | 404 | 34 | Nie znaleziono ID albo ścieżka, której amodb nie udostępnia | | 405 | 37 | Metoda zapisu, którą twój kod nadal wywołuje | | 429 | 25 | Więcej żądań, niż plan dopuszcza w 60 sekund | 402 traktuj jako sygnał do ręcznego odnowienia, bo nic nie odnawia się automatycznie. Pełna lista jest na stronie [błędy](https://amodb.dev/pl/errors/). ## Cennik amodb jest przedpłacone. Wybierz okres 1, 3, 6, 12 lub 24 miesięcy, za który jest zniżka 0, 10, 20, 30 lub 40 procent, oraz jeden z trzech planów z 20, 40 lub 120 żądaniami na minutę. Każdy plan dostaje wszystkie dane i nic nie odnawia się automatycznie. Nie ma darmowego planu ani wersji próbnej. Aktualne kwoty są na stronie [cennik](https://amodb.dev/pl/pricing/). ## Pytania i odpowiedzi ### Czy amodb to bezpośredni zamiennik API TMDB? Dla większości endpointów odczytu tak. Ścieżki, parametry zapytania i pola JSON podążają za TMDB v3, a działa zarówno api_key, jak i uwierzytelnianie Bearer. Metody zapisu zwracają 405 z status_code 37. Kanały zmian, aggregate credits, wyszukiwanie wpisów obsady i recenzji oraz kilka innych ścieżek zwracają 404 z status_code 34. ### Czy moje adresy obrazów z TMDB nadal będą działać? Kształt ścieżki i tokeny rozmiarów pozostają te same, ale host to img.amodb.dev i klucz nie jest potrzebny. Odczytaj images.secure_base_url z endpointu konfiguracji zamiast wpisywać host na stałe, a twój kod obrazów nie wymaga innej zmiany. ### Czy amodb przyjmuje nagłówek Bearer jak TMDB? Tak. Wyślij Authorization: Bearer ze swoim kluczem amodb albo przekaż parametr zapytania api_key. Klucz ma 32 małe znaki szesnastkowe, ten sam kształt co klucz TMDB v3. ### Jak koszt wypada w porównaniu z darmowym API TMDB? TMDB oferuje darmowe API dla kwalifikowanego użycia według własnych warunków. amodb nie ma darmowego planu ani wersji próbnej. Przedpłacasz od 1 do 24 miesięcy na jednym z trzech planów, a aktualne kwoty podaje strona z cennikiem. ### Na jaki limit mam planować? Dopasuj do swojej najbardziej obciążonej minuty. Plany dopuszczają 20, 40 lub 120 żądań na minutę na klucz w przesuwanym oknie 60 sekund, a każdy plan zwraca wszystkie dane. Nagłówki odpowiedzi pokazują, ile żądań zostało. ## Powiązane strony - [amodb vs TMDB](https://amodb.dev/pl/amodb-vs-tmdb/): Bezpośrednie porównanie amodb i TMDB: zgodność endpointów, ścieżki, których amodb nie udostępnia, darmowe i płatne warunki, 14 języków, rozszerzenia i limity. - [Alternatywa dla OMDb API](https://amodb.dev/pl/omdb-api-alternative/): Dzienny limit OMDb to za mało? amodb odpowiada na żądania w stylu OMDb i obsługuje też TMDB v3 na jednym kluczu, bez większych zmian w kodzie klienta. - [API bazy filmów do twojego własnego katalogu](https://amodb.dev/pl/movie-database-api/): API bazy filmów do własnej lokalnej kopii: filmy, osoby, firmy, kolekcje i słowa kluczowe z powiązanymi ID, okna dat w discover i wyszukiwanie po ID. - [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut. - [Limity żądań](https://amodb.dev/pl/rate-limits/): amodb limituje klucz liczbą żądań na minutę w przesuwanym oknie 60 sekund: 20, 40 lub 120 zależnie od planu. Czytaj nagłówki limitu i obsłuż 429 z Retry-After. - [Cennik](https://amodb.dev/pl/pricing/): Plany amodb płatne z góry różnią się tylko limitem żądań na minutę: 20, 40 lub 120. Każdy plan ma wszystkie dane TMDB v3 i OMDb. Bez odnowień i okresu próbnego. Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/tmdb-api-alternative/