# Clé API TMDB : une clé compatible en environ 1 minute

> Pour obtenir une clé API TMDB pour un projet commercial, connectez-vous à amodb avec un e-mail et un code à usage unique, payez une offre et créez la clé. Cela prend environ une minute. La clé a la forme de TMDB v3 : vous changez l'URL de base et gardez votre code. Il n'y a pas d'offre gratuite.

## Obtenir une clé compatible TMDB en quatre étapes

amodb vend des clés pour sa propre API, qui garde les chemins et le JSON de TMDB v3. Ce n'est pas une clé TMDB et elle ne fonctionne pas sur api.themoviedb.org. Vous obtenez une clé de même forme, 32 caractères hexadécimaux en minuscules, que votre client TMDB accepte après un seul changement d'URL de base.

1. Ouvrez les [tarifs](https://amodb.dev/fr/pricing/) et choisissez une offre : 20, 40 ou 120 requêtes par minute. Chaque offre renvoie toutes les données.
2. Connectez-vous avec votre e-mail. amodb envoie un code à 6 chiffres valable 10 minutes. Il n'y a pas de mot de passe.
3. Payez par carte, Apple Pay ou Google Pay pour 1 à 24 mois. Rien ne se renouvelle automatiquement.
4. Ouvrez **Compte**, puis **Clés d'API**, et créez une clé. Copiez-la tout de suite, car la clé complète n'est affichée qu'une fois.

Ces étapes prennent environ une minute, et la clé fonctionne dès que le paiement est confirmé.

## Utiliser la clé : changer l'URL de base

Gardez votre code TMDB et changez deux valeurs : l'URL de base et la clé. Les deux façons d'envoyer la clé fonctionnent, `api_key` dans la requête et un en-tête `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"
```

Le même appel avec un en-tête Bearer, dans trois langages :

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

La réponse a la forme de 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"
}
```

Lisez `images.secure_base_url` dans `/3/configuration` pour que les liens des affiches pointent vers `img.amodb.dev`. Les images n'exigent aucune clé. Pour en savoir plus sur l'envoi de la clé, voir [authentification](https://amodb.dev/fr/authentication/) ; un tutoriel plus long se trouve dans le [démarrage rapide](https://amodb.dev/fr/quickstart/).

## Une clé TMDB gratuite et une clé amodb côte à côte

Le bon choix dépend de votre projet et de vos conditions, pas d'une liste de fonctionnalités. La colonne TMDB reprend seulement ce que TMDB publie en général. Lisez les conditions et la documentation de TMDB pour connaître les règles actuelles.

|                     | Clé TMDB gratuite                                                   | Clé amodb                                                                                                 |
| ------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Prix                | Gratuite pour un usage admissible selon les conditions de TMDB      | Payante, prépayée pour 1 à 24 mois, sans essai                                                            |
| Comment l'obtenir   | Un compte TMDB et une demande de clé sur le site de TMDB            | E-mail, code à 6 chiffres, paiement, puis création de la clé dans votre compte                            |
| Usage commercial    | Voir les conditions de TMDB sur l'usage commercial et l'attribution | Autorisé par les conditions d'amodb                                                                       |
| Limite de débit     | Fixée par TMDB, voir leur documentation                             | 20, 40 ou 120 requêtes par minute selon l'offre                                                           |
| Données             | Données TMDB                                                        | Forme TMDB v3, plus `ratings`, `moods`, `soundtracks`, `wikidata` et `showtimes` via `append_to_response` |
| Format de la clé    | Clé v3, 32 caractères hexadécimaux                                  | 32 caractères hexadécimaux en minuscules                                                                  |
| URL de base         | `https://api.themoviedb.org/3`                                      | `https://api.amodb.dev/3`                                                                                 |
| Méthodes d'écriture | Méthodes de compte, de liste et de notation                         | Non proposées, elles répondent 405                                                                        |

## Quand une clé TMDB gratuite suffit

Restez sur une clé TMDB gratuite pour un projet personnel ou d'apprentissage qui respecte les conditions de TMDB. Si votre usage est admissible, TMDB ne coûte rien et amodb ne peut pas rivaliser.

Utilisez une clé amodb quand le projet est commercial et que vous voulez un contrat payant, quand il vous faut une limite fixe par minute pour planifier, ou quand la page d'un titre doit recevoir les notes de cinq sources en un seul appel. Vérifiez d'abord les écarts : les méthodes d'écriture, les flux de changements et quelques autres chemins ne sont pas proposés. Ils sont listés dans [alternative à l'API TMDB](https://amodb.dev/fr/tmdb-api-alternative/) et dans [amodb vs TMDB](https://amodb.dev/fr/amodb-vs-tmdb/).

## Usage commercial et limites

L'usage commercial est autorisé par les [conditions d'utilisation](https://amodb.dev/fr/terms/) d'amodb. Vous pouvez afficher les données dans vos applications, sites, bots et outils internes, et mettre les réponses en cache pour économiser des requêtes. Vous ne pouvez pas revendre l'accès brut à l'API, publier des exports en masse, partager des clés ni ouvrir des comptes supplémentaires pour augmenter votre débit. La liste complète est dans la [politique d'utilisation acceptable](https://amodb.dev/fr/acceptable-use/).

L'offre fixe le débit. Chaque réponse porte `X-RateLimit-Limit`, `X-RateLimit-Remaining` et `X-RateLimit-Reset`, et une réponse 429 ajoute `Retry-After`. Les détails sont sur [limites de débit](https://amodb.dev/fr/rate-limits/).

## Questions et réponses

### Est-ce une clé API TMDB ?

Non. C'est une clé amodb. Elle a la même forme qu'une clé TMDB v3, 32 caractères hexadécimaux en minuscules, et fonctionne sur les chemins d'amodb compatibles TMDB v3 à l'adresse https://api.amodb.dev/3. Elle ne fonctionne pas sur api.themoviedb.org, et amodb est un service indépendant.

### Puis-je obtenir une clé API TMDB gratuitement ?

TMDB propose une clé gratuite pour un usage admissible selon ses propres conditions, et vous la demandez sur le site de TMDB. amodb n'a ni offre gratuite ni essai : une clé amodb vient donc toujours avec une offre payante. Lisez les conditions de TMDB avant de décider laquelle vous convient.

### Puis-je obtenir une clé API TMDB sans inscription ?

Pas sur amodb. Vous vous connectez avec un e-mail et un code à 6 chiffres, sans mot de passe ni formulaire de demande, puis vous payez et créez la clé. Une clé TMDB demande un compte TMDB : consultez le site de TMDB pour les étapes actuelles.

### Puis-je utiliser la clé dans un projet commercial ?

Oui. L'usage commercial est autorisé par les conditions d'amodb. Utilisez les données dans vos propres applications et sites, mais ne revendez pas l'accès brut à l'API, ne partagez pas votre clé et ne la mettez pas dans du code côté client.

### Combien de requêtes une clé peut-elle faire ?

L'offre fixe le débit : 20, 40 ou 120 requêtes par minute et par clé, comptées sur une fenêtre glissante de 60 secondes. Chaque offre renvoie toutes les données et il n'y a pas de plafond quotidien.

## Pages liées

- [Alternative à l'API TMDB](https://amodb.dev/fr/tmdb-api-alternative/): Besoin d'une alternative à l'API TMDB ? Comparez conditions, limites et langues, puis passez à une API payante qui garde la plupart des chemins TMDB v3.
- [Démarrage rapide](https://amodb.dev/fr/quickstart/): Faites votre premier appel amodb : obtenez une clé, demandez un film en curl, JavaScript, Python, PHP ou Go, puis chargez l'affiche. En moins de 2 minutes.
- [Tarifs](https://amodb.dev/fr/pricing/): Les offres amodb ne diffèrent que par les requêtes par minute : 20, 40 ou 120. Toutes incluent les données TMDB v3 et OMDb. Prépayé, sans renouvellement.
- [Authentification](https://amodb.dev/fr/authentication/): Comment envoyer votre clé amodb : api_key dans la requête, en-tête Authorization Bearer, ou apikey pour OMDb. Format, stockage, rotation et erreurs 401.
- [amodb vs TMDB](https://amodb.dev/fr/amodb-vs-tmdb/): Comparatif amodb et TMDB : parité des endpoints, chemins non proposés, conditions gratuites ou payantes, 14 langues, extensions et limites de débit.
- [Limites de débit](https://amodb.dev/fr/rate-limits/): amodb limite chaque clé en requêtes par minute sur une fenêtre glissante de 60 secondes : 20, 40 ou 120 selon l'offre. Lisez les en-têtes et gérez le 429.

Mis à jour: 2026-10-19. Source: https://amodb.dev/fr/tmdb-api-key/