Accueil / Guides / Limite gratuite de l'API d'inférence Hugging Face

Limite gratuite de l'API d'inférence Hugging Face

Hugging Face Inference Providers est une API unique pour les modèles ouverts de nombreux fournisseurs d'inférence. Elle incluait autrefois un petit crédit mensuel gratuit pour chaque compte. Aujourd'hui, la page tarifaire officielle n'indique aucun crédit mensuel pour les utilisateurs gratuits. Ce guide explique les règles actuelles, l'erreur 402 et les options gratuites.

Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.

La limite gratuite actuelle

La page tarifaire de Hugging Face pour Inference Providers présente un tableau des crédits mensuels par type de compte. Les utilisateurs gratuits ne reçoivent aucun crédit mensuel. Ils ne peuvent utiliser Inference Providers qu'en achetant des crédits ou en passant à PRO.

Crédits mensuels Inference Providers, d'après la page tarifaire de Hugging Face (vérifié le 20 novembre 2026)
Type de compteCrédit mensuelPaiement à l'usage
Utilisateur gratuitAucunOui, achat de crédits requis
Utilisateur PRO$2.00Oui
Organisation Team ou Enterprise2,00 $ par siège, partagés dans l'organisationOui
Ancien chiffre : de nombreuses pages indiquent encore que les utilisateurs gratuits reçoivent 0,10 $ par mois. Ce chiffre ne figure plus sur la page tarifaire officielle. Des outils de suivi tiers ont relevé le changement en octobre 2026. Les anciennes pages de documentation de Hugging Face peuvent encore afficher l'ancienne valeur.

Les crédits PRO et Team sont des crédits de calcul généraux. Vous pouvez aussi les dépenser pour Inference Endpoints, le matériel Spaces et Jobs. Hugging Face facture au tarif du fournisseur, sans frais supplémentaires.

Pourquoi vous obtenez l'erreur 402

HTTP 402 signifie paiement requis. Avec Inference Providers, vous l'obtenez en général lorsque votre compte n'a plus de crédit. Sur un compte gratuit sans crédit acheté, la première requête payante peut renvoyer 402.

CauseSolution
Compte gratuit sans crédit achetéAchetez des crédits sur la page de facturation, ou passez à PRO
Le crédit PRO de ce mois est épuiséAttendez le mois suivant, ou achetez davantage de crédits
La requête est facturée à une organisation sans créditSupprimez l'en-tête X-HF-Bill-To, ou demandez à l'administrateur de l'organisation d'ajouter du crédit

Une autre erreur peut survenir lorsqu'une organisation désactive un fournisseur. Si vous demandez ce fournisseur par son nom, la requête échoue. Utilisez la sélection automatique du fournisseur, ou choisissez un autre fournisseur.

Vérifiez votre usage sur la page des paramètres d'Inference Providers. Elle affiche l'usage du mois passé, par modèle et par fournisseur.

Fonctionnement de l'API

  1. Connectez-vous à Hugging Face et ouvrez les paramètres des jetons.
  2. Créez un jeton à granularité fine.
  3. Accordez au jeton la permission « Make calls to Inference Providers ».
  4. Enregistrez le jeton dans la variable d'environnement HF_TOKEN.
  5. Achetez des crédits ou passez à PRO. Sans crédit, un compte gratuit ne peut pas effectuer de requêtes payantes.

Inference Providers dispose d'un point de terminaison compatible OpenAI pour les complétions de chat, à l'adresse https://router.huggingface.co/v1. Vous vous authentifiez avec un jeton Hugging Face à granularité fine, qui a la permission d'appeler Inference Providers.

Client OpenAI avec un jeton Hugging Face

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://router.huggingface.co/v1",
    api_key=os.environ["HF_TOKEN"],
)

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4.1-Flash:fastest",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
  • Ajoutez :fastest à l'identifiant du modèle pour choisir le fournisseur au débit le plus élevé.
  • Ajoutez :cheapest pour choisir le fournisseur au prix le plus bas.
  • Ajoutez le nom d'un fournisseur, par exemple :novita, pour en choisir un seul.
  • Le point de terminaison compatible OpenAI ne sert qu'au chat. Utilisez les bibliothèques clientes de Hugging Face pour les images, les embeddings et la synthèse vocale.

À quoi sert Inference Providers

  • Tester de nombreux modèles ouverts avec un seul jeton, avant d'en choisir un pour la production.
  • Des modèles rares ailleurs, par exemple de nouvelles versions à poids ouverts et des modèles spécialisés.
  • Des modèles d'images, de vidéo et d'audio via les bibliothèques clientes de Hugging Face.
  • Les équipes qui paient déjà PRO ou Team, car le crédit inclus s'applique en premier.

Vous pouvez aussi télécharger de nombreux modèles ouverts depuis le Hub et les exécuter sur votre propre matériel. Des outils comme llama.cpp, vLLM et Ollama les servent en local. L'inférence locale ne consomme aucun crédit d'API, mais elle nécessite un GPU ou un ordinateur rapide. FreeLLMAPI peut ajouter un serveur local compatible OpenAI comme fournisseur personnalisé, à côté des offres cloud gratuites.

Inference Providers n'est pas une API gratuite pour un usage quotidien. Sans crédit mensuel, un compte gratuit paie chaque requête après l'achat. Le crédit PRO de 2,00 $ est aussi insuffisant pour un agent ou une application de chat.

Options gratuites pour les modèles ouverts

De nombreux modèles ouverts sur Hugging Face disposent aussi d'offres gratuites renouvelables chez d'autres fournisseurs. Le tableau présente les modèles gratuits les plus performants du catalogue actuel.

Modèles gratuits les plus performants du catalogue actuel
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3APINex, UnoRouter1M5 req/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
OuiNon
Qwen3.8 MaxACLIDE-€20/month shared internal usage credits · no cardOuiNon
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 de plus1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashAPINex, Google AI Studio1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
OuiOui
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub, Inferbase1M$0.25/week shared recurring creditOuiOui
Deepseek V4.1 FlashAPINex1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NonNon
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
Agnes 3.0 FlashAgnes AI-Promo $0/tokenNonNon

Affichage de 12 modèles gratuits sur 354 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

FreeLLMAPI dispose d'un adaptateur pour Hugging Face. Le catalogue gratuit actuel ne contient aucune ligne Hugging Face, car les comptes gratuits n'ont pas de crédit renouvelable. Pour utiliser des modèles ouverts gratuits avec une seule clé, ajoutez des clés des fournisseurs du tableau. Le routeur passe au fournisseur suivant lorsqu'un fournisseur renvoie une erreur de limite de débit.

Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

Questions fréquentes

L'API d'inférence Hugging Face est-elle gratuite ?

Pas pour les comptes gratuits. La page tarifaire actuelle n'indique aucun crédit mensuel pour les utilisateurs gratuits. Ils doivent acheter des crédits ou passer à PRO, qui inclut 2,00 $ de crédit de calcul par mois.

Les utilisateurs gratuits de Hugging Face reçoivent-ils encore 0,10 $ par mois ?

La page tarifaire officielle ne l'indique plus aujourd'hui. Elle n'indique aucun crédit mensuel pour les utilisateurs gratuits. Les anciennes pages et certaines copies de la documentation affichent encore le chiffre de 0,10 $.

Pourquoi Hugging Face renvoie-t-il l'erreur 402 Payment Required ?

Votre compte, ou l'organisation facturée, n'a plus de crédit. Achetez des crédits, passez à PRO, ou attendez le prochain crédit PRO mensuel.

Le routeur Hugging Face est-il compatible OpenAI ?

Oui, pour les complétions de chat. Définissez l'URL de base sur https://router.huggingface.co/v1 et utilisez un jeton Hugging Face comme clé d'API.

Quelle est une alternative gratuite à Hugging Face Inference ?

Utilisez des fournisseurs qui proposent des offres gratuites renouvelables pour les modèles ouverts, comme Groq, NVIDIA NIM, Cloudflare Workers AI ou OVH AI Endpoints. FreeLLMAPI les regroupe derrière une seule clé.

Guides associés

Sources

Tous les guides · Parcourir tous les modèles gratuits