# Chave da API do TMDB: uma chave compatível em cerca de 1 minuto

> Para obter uma chave da API do TMDB em um projeto comercial, entre no amodb com e-mail e um código de uso único, pague um plano e crie a chave. Leva cerca de um minuto. A chave tem o formato do TMDB v3, então você troca a URL base e mantém o código. Não existe plano gratuito.

## Obtenha uma chave compatível com o TMDB em quatro passos

O amodb vende chaves para a própria API, que mantém os caminhos e o JSON do TMDB v3. Não é uma chave do TMDB e não funciona em api.themoviedb.org. O que você recebe é uma chave com o mesmo formato, 32 caracteres hexadecimais minúsculos, que o seu cliente TMDB aceita depois de uma única troca de URL base.

1. Abra [preços](https://amodb.dev/pt/pricing/) e escolha um plano: 20, 40 ou 120 requisições por minuto. Todo plano retorna todos os dados.
2. Entre com seu e-mail. O amodb envia um código de 6 dígitos válido por 10 minutos. Não há senha.
3. Pague com cartão, Apple Pay ou Google Pay por 1 a 24 meses. Nada renova automaticamente.
4. Abra **Conta**, depois **Chaves de API**, e crie uma chave. Copie-a na hora, porque a chave completa é exibida uma só vez.

Os passos levam cerca de um minuto, e a chave funciona assim que o pagamento é confirmado.

## Use a chave: troque a URL base

Mantenha seu código do TMDB e troque dois valores, a URL base e a chave. As duas formas de enviar a chave funcionam, `api_key` na consulta e um cabeçalho `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"
```

A mesma chamada com um cabeçalho Bearer, em três linguagens:

```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"])
```

A resposta tem o formato do 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"
}
```

Leia `images.secure_base_url` em `/3/configuration` para que os links dos pôsteres apontem para `img.amodb.dev`. As imagens não precisam de chave. Mais detalhes sobre o envio da chave estão em [autenticação](https://amodb.dev/pt/authentication/), e um passo a passo mais longo está no [início rápido](https://amodb.dev/pt/quickstart/).

## Uma chave gratuita do TMDB e uma chave do amodb lado a lado

A escolha certa depende do seu projeto e dos seus termos, não de uma lista de recursos. A coluna do TMDB apenas repete o que o TMDB publica de forma geral. Leia os termos e a documentação do próprio TMDB para ver as regras atuais.

|                       | Chave gratuita do TMDB                                      | Chave do amodb                                                                                                     |
| --------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Preço                 | Grátis para uso elegível, conforme os termos do TMDB        | Paga, pré-paga por 1 a 24 meses, sem período de teste                                                              |
| Como obter            | Uma conta no TMDB e um pedido de chave no site do TMDB      | E-mail, código de 6 dígitos, pagamento e depois criar a chave na sua conta                                         |
| Uso comercial         | Consulte os termos do TMDB sobre uso comercial e atribuição | Permitido pelos termos do amodb                                                                                    |
| Limite de requisições | Definido pelo TMDB, confira a documentação dele             | 20, 40 ou 120 requisições por minuto, conforme o plano                                                             |
| Dados                 | Dados do TMDB                                               | Formato TMDB v3, mais `ratings`, `moods`, `soundtracks`, `wikidata` e `showtimes` por meio de `append_to_response` |
| Formato da chave      | Chave v3, 32 caracteres hexadecimais                        | 32 caracteres hexadecimais minúsculos                                                                              |
| URL base              | `https://api.themoviedb.org/3`                              | `https://api.amodb.dev/3`                                                                                          |
| Métodos de escrita    | Métodos de conta, lista e avaliação                         | Não oferecidos, respondem 405                                                                                      |

## Quando uma chave gratuita do TMDB basta

Fique com uma chave gratuita do TMDB para um projeto pessoal ou de estudo que se encaixe nos termos do TMDB. Se o seu uso for elegível, o TMDB não custa nada e o amodb não consegue igualar isso.

Use uma chave do amodb quando o projeto for comercial e você quiser um acordo pago, quando precisar de um limite fixo por minuto para se planejar, ou quando a página de um título deva receber avaliações de cinco fontes em uma única chamada. Confira antes as lacunas: métodos de escrita, feeds de alterações e alguns outros caminhos não são oferecidos. Eles estão listados em [alternativa à API do TMDB](https://amodb.dev/pt/tmdb-api-alternative/) e em [amodb vs TMDB](https://amodb.dev/pt/amodb-vs-tmdb/).

## Uso comercial e limites

O uso comercial é permitido pelos [termos de uso](https://amodb.dev/pt/terms/) do amodb. Você pode exibir os dados em seus apps, sites, bots e ferramentas internas, e guardar respostas em cache para economizar requisições. Você não pode revender o acesso bruto à API, publicar dumps em massa, compartilhar chaves nem abrir contas extras para aumentar sua taxa. A lista completa está na [política de uso aceitável](https://amodb.dev/pt/acceptable-use/).

O plano define a taxa. Toda resposta traz `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`, e um 429 acrescenta `Retry-After`. Os detalhes estão em [limites de requisições](https://amodb.dev/pt/rate-limits/).

## Perguntas e respostas

### Esta é uma chave da API do TMDB?

Não. É uma chave do amodb. Ela tem o mesmo formato de uma chave do TMDB v3, 32 caracteres hexadecimais minúsculos, e funciona nos caminhos compatíveis com o TMDB v3 do amodb em https://api.amodb.dev/3. Não funciona em api.themoviedb.org, e o amodb é um serviço independente.

### Posso obter uma chave da API do TMDB de graça?

O TMDB oferece uma chave gratuita para uso elegível, conforme os termos dele, e você a solicita no site do TMDB. O amodb não tem plano gratuito nem período de teste, então uma chave do amodb sempre vem com um plano pago. Leia os termos do TMDB antes de decidir qual dos dois serve para você.

### Posso obter uma chave da API do TMDB sem cadastro?

No amodb, não. Você entra com um e-mail e um código de 6 dígitos, sem senha e sem formulário de solicitação, depois paga e cria a chave. Uma chave do TMDB exige uma conta no TMDB, então confira no site do TMDB os passos atuais.

### Posso usar a chave em um projeto comercial?

Sim. O uso comercial é permitido pelos termos do amodb. Use os dados nos seus próprios apps e sites, mas não revenda o acesso bruto à API, não compartilhe sua chave nem a coloque em código do lado do cliente.

### Quantas requisições uma chave pode fazer?

O plano define a taxa: 20, 40 ou 120 requisições por minuto por chave, contadas em uma janela deslizante de 60 segundos. Todo plano retorna todos os dados e não há limite diário.

## Páginas relacionadas

- [Alternativa à API do TMDB](https://amodb.dev/pt/tmdb-api-alternative/): Precisa de uma alternativa à API do TMDB? Veja termos, limites, idiomas e avaliações, e migre para uma API paga com a maioria dos caminhos de leitura da v3.
- [Início rápido](https://amodb.dev/pt/quickstart/): Faça sua primeira chamada ao amodb: obtenha uma chave, peça um filme em curl, JavaScript, Python, PHP ou Go e carregue o pôster. Menos de 2 minutos.
- [Preços](https://amodb.dev/pt/pricing/): Os planos do amodb diferem só em requisições por minuto: 20, 40 ou 120. Todo plano inclui todos os dados do TMDB v3 e OMDb. Pré-pago, sem renovação nem teste.
- [Autenticação](https://amodb.dev/pt/authentication/): Como enviar sua chave do amodb: api_key na consulta, um cabeçalho Authorization Bearer ou apikey nas chamadas OMDb. Formato, armazenamento, rotação e erros 401.
- [amodb vs TMDB](https://amodb.dev/pt/amodb-vs-tmdb/): Comparação direta entre amodb e TMDB: paridade de endpoints, caminhos que o amodb não oferece, termos gratuitos e pagos, 14 idiomas, extensões e limites.
- [Limites de requisições](https://amodb.dev/pt/rate-limits/): O amodb limita cada chave por requisições por minuto em uma janela de 60 segundos: 20, 40 ou 120 por plano. Leia os cabeçalhos e trate o 429 com Retry-After.

Atualizado: 2026-10-19. Source: https://amodb.dev/pt/tmdb-api-key/