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.
| Type de compte | Crédit mensuel | Paiement à l'usage |
|---|---|---|
| Utilisateur gratuit | Aucun | Oui, achat de crédits requis |
| Utilisateur PRO | $2.00 | Oui |
| Organisation Team ou Enterprise | 2,00 $ par siège, partagés dans l'organisation | Oui |
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.
| Cause | Solution |
|---|---|
| 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édit | Supprimez 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
- Connectez-vous à Hugging Face et ouvrez les paramètres des jetons.
- Créez un jeton à granularité fine.
- Accordez au jeton la permission « Make calls to Inference Providers ».
- Enregistrez le jeton dans la variable d'environnement
HF_TOKEN. - 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
:cheapestpour 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èle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Oui | Non |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | Oui | Non |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 de plus | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Oui | Oui |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Deepseek V4.1 Flash | APINex | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Non | Non |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | Non | Non |
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.
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
- URL de base des API gratuites compatibles OpenAI
- API LLM gratuite sans carte bancaire
- Limites de débit des API LLM gratuites
- API gratuite OVH AI Endpoints
- API d'embeddings gratuite
Sources
- Hugging Face docs: Inference Providers pricing and billing (vérifié le 20 November 2026)
- Hugging Face docs: Inference Providers (vérifié le 20 November 2026)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (vérifié le 20 November 2026)
- FreeLLMAPI docs: Supported platforms (vérifié le 20 November 2026)