# Alternativa k API TMDB > Alternativu k API TMDB hledejte, když chcete placenou smlouvu, limit požadavků, podle kterého lze plánovat, nebo víc dat v každé odpovědi. amodb mluví protokolem TMDB v3 pro čtení, takže měníte základní URL a klíč. Zápisy a několik cest se nenabízí. Zůstaňte u TMDB, pokud vám bezplatné podmínky vyhovují. ## Které API zvolit TMDB nabízí bezplatné API pro kvalifikované užití podle vlastních podmínek, s klíči API v3 a tokeny v4. Než produkt nasadíte, přečtěte si tyto podmínky komerčního užití a uvádění zdroje. Alternativu zvolte, když chcete placenou smlouvu, limit, podle kterého lze plánovat, nebo víc dat v každé odpovědi. amodb je nezávislé API, které mluví protokolem TMDB v3 pro čtení, takže přechod znamená novou základní URL a nový klíč. Je jen pro čtení a několik cest TMDB se nenabízí, jak je uvedeno níže. Zůstaňte u TMDB, pokud vašemu projektu bezplatné podmínky vyhovují a nic v další části se vás netýká. ## Signály, že potřebujete alternativu Rozhodnout pomáhá pět kontrol. Spusťte je proti vlastnímu provozu a vlastní smlouvě, ne proti seznamu funkcí. | Signál | Co otestovat | Jak odpovídá amodb | | ----------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | Komerční podmínky | Přečtěte si podmínky API, které dnes používáte, kvůli komerčnímu užití a uvádění zdroje | Placené tarify, předplacené, bez automatického obnovení | | Špičkový provoz | Spočítejte požadavky ve své nejvytíženější minutě | Pevný limit 20, 40 nebo 120 požadavků za minutu na klíč | | Data na obrazovku | Vypište dodatečná volání za stránkou jednoho titulu | `append_to_response` přijímá také `ratings`, `moods`, `soundtracks`, `wikidata` a `showtimes` | | Jazyk rozhraní | Ověřte každý jazyk, který dodáváte | 14 jazyků, cokoli jiného se vrátí k `en` | | Náklady na odchod | Spočítejte řádky kódu, které jmenují dodavatele | Stejné cesty a JSON na poskytovaných endpointech, odchod je tedy také jen změna základní URL | Zásahy cache se také počítají. Kontrola klíče a limitu proběhne před cache na edge, takže opakovaný požadavek stále spotřebuje jeden z vašich požadavků za minutu. Plánujte podle celkového počtu požadavků, ne podle minutí cache. ## Srovnání funkcí | Funkce | TMDB | amodb | | ---------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------- | | Cenový model | Bezplatné API pro kvalifikované užití podle vlastních podmínek | Předplacená období 1, 3, 6, 12 nebo 24 měsíců | | Bezplatný tarif | Ano, pro kvalifikované užití | Žádný, ani zkušební verze | | Ověření | Klíč v3 v `api_key`, nebo token v4 jako Bearer | `api_key` nebo Bearer, klíč o 32 hexadecimálních znacích | | Formát odpovědi | JSON | JSON ve tvaru TMDB v3 | | Jazyky | Podívejte se do jejich dokumentace | 14 jazyků rozhraní | | Filmy | Ano | Ano | | Seriály | Ano | Ano, se sezónami a epizodami | | Osoby | Ano | Ano | | Obrázky | Ano, z vlastního hostitele obrázků | `img.amodb.dev`, stejné tokeny velikostí, bez klíče | | Hodnocení | Skóre uživatelů TMDB, u jiných zdrojů se podívejte do jejich dokumentace | Skóre TMDB plus IMDb, Kinopoisk, Metacritic a Rotten Tomatoes, kde jsou známé | | Metody pro zápis | Metody účtu, seznamů a hodnocení | Nenabízí se, odpovídají 405 | | Limit požadavků | Podívejte se do jejich dokumentace | 20, 40 nebo 120 za minutu na klíč | | Komerční užití | Ověřte si jejich podmínky komerčního užití a uvádění zdroje | Prodává se jako placené API, viz [ceník](https://amodb.dev/cs/pricing/) | | Kompatibilita | Definuje protokol v3 | Většina cest pro čtení v3 plus OMDb | ## V čem se amodb liší - **Limity, které si přečtete.** Každá odpověď s klíčem nese `X-RateLimit-Limit`, `X-RateLimit-Remaining` a `X-RateLimit-Reset` v sekundách. 429 přidává `Retry-After`. Čísla vysvětluje stránka [limity požadavků](https://amodb.dev/cs/rate-limits/). - **Další bloky v jednom volání.** Hodnocení z pěti zdrojů, měřiče nálady, soundtracky, fakta z Wikidata a promítací časy kin přicházejí přes `append_to_response`, takže stránka jednoho titulu může použít jediný požadavek. - **Více zdrojů externích ID.** `/3/find` převádí `imdb_id`, `tvdb_id`, `wikidata_id` a `kinopoisk_id` a také `facebook_id`, `twitter_id` a `instagram_id`. Viz [hledání podle externího ID](https://amodb.dev/cs/find-by-external-id/). - **OMDb na stejném klíči.** `https://api.amodb.dev/omdb/` odpovídá na volání ve stylu OMDb s parametrem `apikey`, což pomáhá, když dva vaše systémy používají různé protokoly. - **Známé doby cache.** Detaily a obsazení zůstávají 6 hodin na edge, trending a discover 30 minut, vyhledávání 10 minut, konfigurace 24 hodin a obrázky 30 dní. ## Kdy se TMDB hodí lépe - **Bezplatné projekty.** Pokud vaše užití splňuje bezplatné podmínky, TMDB nestojí nic a amodb to nemůže vyrovnat. - **Uživatelské metody pro zápis.** TMDB nabízí metody pro zápis účtu, relace, hodnocení a seznamů. amodb na ně odpovídá 405 a status_code 37, takže aplikace, která lidem umožňuje přihlásit se a hodnotit tituly, by pro tuto část měla ponechat TMDB. - **Feedy změn.** TMDB uvádí ID, která se změnila. amodb takový feed nemá, obnovujete tedy podle vlastního rozvrhu. - **Více než 14 jazyků.** amodb neposkytuje text rozhraní v němčině, japonštině ani korejštině a vrací se k angličtině. Původní názvy přesto přicházejí v `original_title` a `original_name`. Další jazyky na TMDB ověřte v jejich dokumentaci. - **Podmínky, které jste už přijali.** Pokud je právní posouzení pro TMDB hotové, přechod vás stojí další posouzení. ## Co amodb nenabízí Než přepnete, projděte svůj kód podle tohoto seznamu. Úplná tabulka je na stránce [amodb vs TMDB](https://amodb.dev/cs/amodb-vs-tmdb/). | Volání TMDB | Odpověď amodb | | ------------------------------------------------------------------------------------- | ----------------------------- | | Zápisy účtu, relace, hodnocení a seznamů | 405, `status_code` 37 | | Changes, aggregate credits, vyhledání záznamů obsazení a recenzí, obsah skupin epizod | 404, `status_code` 34 | | Překlady osob, obrázky a překlady kolekcí, společností a sítí | 404, `status_code` 34 | | Seznam recenzí u filmu nebo seriálu | 200, u většiny titulů prázdný | | Obrázky, videa a překlady sezón | 200, prázdné | | Externí ID sezón a epizod | 200, všechna null | Dvě chování jsou tichá. Název v `append_to_response`, který amodb nezná, například `aggregate_credits`, se bez chyby ignoruje. Parametr `include_adult` se také ignoruje, protože tituly a osoby pro dospělé se nikdy neposkytují. ## Přechod na amodb 1. Vyberte tarif na stránce [ceník](https://amodb.dev/cs/pricing/) a vytvořte klíč v panelu účtu. 2. Základní URL a klíč nahraďte na jednom místě, jak je uvedeno níže. 3. Přečtěte `images.secure_base_url` z `/3/configuration`, aby odkazy na obrázky používaly `img.amodb.dev`. 4. Odstraňte volání metod pro zápis a cest z tabulky výše. 5. Ošetřete 429 čekáním `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); ``` Před přepnutím spusťte stávající testy proti oběma základním URL. Sdílený tvar nezaručuje shodné hodnoty, porovnejte proto vzorek vlastních titulů. Úplný postup je v [rychlém startu](https://amodb.dev/cs/quickstart/) a tabulka vedle sebe na stránce [amodb vs TMDB](https://amodb.dev/cs/amodb-vs-tmdb/). ### Zpracování chyb se přenáší Neúspěšná volání vracejí tělo TMDB `{"success": false, "status_code": N, "status_message": "..."}`, kód, který větví podle `status_code`, tedy nepotřebuje přepsat. | HTTP | status_code | Typická příčina | | ---- | ----------- | ------------------------------------------------ | | 401 | 7 | Klíč chybí nebo je s překlepem | | 401 | 10 | Klíč je pozastaven | | 402 | 36 | Předplacené období skončilo | | 404 | 34 | ID nenalezeno, nebo cesta, kterou amodb nenabízí | | 405 | 37 | Metoda pro zápis, kterou váš kód stále volá | | 429 | 25 | Více požadavků, než tarif povoluje za 60 sekund | 402 berte jako signál k ruční obnově, protože se nic neobnovuje automaticky. Úplný seznam je na stránce [chyby](https://amodb.dev/cs/errors/). ## Ceník amodb je předplacené. Zvolte období 1, 3, 6, 12 nebo 24 měsíců, u kterého je sleva 0, 10, 20, 30 nebo 40 procent, a jeden ze tří tarifů s 20, 40 nebo 120 požadavky za minutu. Každý tarif dostane všechna data a nic se neobnovuje automaticky. Bezplatný tarif ani zkušební verze neexistují. Aktuální částky jsou na stránce [ceník](https://amodb.dev/cs/pricing/). ## Otázky a odpovědi ### Je amodb přímou náhradou API TMDB? U většiny endpointů pro čtení ano. Cesty, parametry dotazu a pole JSON následují TMDB v3 a funguje api_key i ověření Bearer. Metody pro zápis vracejí 405 se status_code 37. Feedy změn, aggregate credits, vyhledání záznamů obsazení a recenzí a několik dalších cest vracejí 404 se status_code 34. ### Budou mé URL obrázků z TMDB dál fungovat? Tvar cesty a tokeny velikostí zůstávají stejné, ale hostitel je img.amodb.dev a klíč není potřeba. Přečtěte images.secure_base_url z endpointu konfigurace místo pevného zadání hostitele a váš kód pro obrázky nepotřebuje další změnu. ### Přijímá amodb hlavičku Bearer jako TMDB? Ano. Pošlete Authorization: Bearer se svým klíčem amodb, nebo předejte parametr dotazu api_key. Klíč má 32 malých hexadecimálních znaků, stejný tvar jako klíč TMDB v3. ### Jak si stojí cena oproti bezplatnému API TMDB? TMDB nabízí bezplatné API pro kvalifikované užití podle vlastních podmínek. amodb nemá bezplatný tarif ani zkušební verzi. Předplácíte 1 až 24 měsíců u jednoho ze tří tarifů a aktuální částky uvádí stránka s ceníkem. ### Na jaký limit mám plánovat? Podle své nejvytíženější minuty. Tarify povolují 20, 40 nebo 120 požadavků za minutu na klíč v klouzavém okně 60 sekund a každý tarif vrací všechna data. Hlavičky odpovědí ukazují, kolik požadavků zbývá. ## Související stránky - [amodb vs TMDB](https://amodb.dev/cs/amodb-vs-tmdb/): Přímé srovnání amodb a TMDB: shoda endpointů, cesty, které amodb nenabízí, bezplatné a placené podmínky, 14 jazyků, rozšíření a limity požadavků. - [Alternativa k OMDb API](https://amodb.dev/cs/omdb-api-alternative/): Narazili jste na denní limit OMDb nebo potřebujete víc než jeden záznam? amodb odpovídá na požadavky ve stylu OMDb a nabízí i TMDB v3 s jedním klíčem. - [API databáze filmů pro váš vlastní katalog](https://amodb.dev/cs/movie-database-api/): API databáze filmů pro vlastní lokální kopii: filmy, osoby, společnosti, kolekce a klíčová slova s propojenými ID, okna dat v discover a vyhledání podle ID. - [Rychlý start](https://amodb.dev/cs/quickstart/): První volání amodb: získejte klíč, vyžádejte detail filmu v curl, JavaScriptu, Pythonu, PHP nebo Go a načtěte plakát z img.amodb.dev. Za méně než 2 minuty. - [Limity požadavků](https://amodb.dev/cs/rate-limits/): amodb omezuje klíč počtem požadavků za minutu v klouzavém okně 60 sekund: 20, 40 nebo 120 podle tarifu. Čtěte hlavičky limitu a řešte 429 pomocí Retry-After. - [Ceník](https://amodb.dev/cs/pricing/): Tarify amodb se liší jen počtem požadavků za minutu: 20, 40 nebo 120. Každý zahrnuje všechna data kompatibilní s TMDB v3 a OMDb. Bez obnovení a zkušební verze. Aktualizováno: 2026-10-18. Source: https://amodb.dev/cs/tmdb-api-alternative/