Calculateur d'écart de PIB
Un PIB effectif de 10 500 pour un potentiel de 10 000 donne un écart de 500, soit 5 % au-dessus du potentiel : un écart inflationniste. Saisissez les deux niveaux de la même période pour voir de combien la production s'éloigne de sa capacité soutenable. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- PIB effectif
- 10 500
- PIB potentiel
- 10 000
- Écart de PIB (GDP)
- 500
- Écart de PIB (GDP) (%)
- 5
- Type d'écart
- inflationary
L’écart de PIB, aussi appelé écart de production, est la différence signée entre le PIB effectif et le PIB potentiel de la même période, exprimée à la fois comme montant monétaire et comme pourcentage du potentiel. Un écart positif signifie que l’économie tourne au-dessus de sa capacité soutenable et se nomme souvent écart inflationniste ; un écart négatif implique du travail et du capital inutilisés et se nomme souvent écart récessionniste ; un écart nul signifie que la production se situe au potentiel. Étudiants, tuteurs, observateurs de banques centrales et rédacteurs d’examens ont besoin d’une identité déterministe qui ne divise jamais par un potentiel nul ou négatif. Ce calculateur accepte le PIB effectif et le PIB potentiel dans les mêmes unités, et renvoie le montant, le pourcentage, une courte étiquette de type et la chaîne de formule.
Ce que mesure l’écart de PIB et comment la formule fonctionne
L’écart de PIB, aussi appelé écart de production dans les manuels et les notes de politique, est la distance signée entre ce qu’une économie a effectivement produit durant une période et ce qu’elle aurait pu produire à utilisation pleine et soutenable de son travail et de son capital. Le PIB effectif est le niveau observé de production, presque toujours un chiffre en volume à prix constants afin qu’un changement de prix ne soit pas pris pour un changement de volume.
Le PIB potentiel est un contrefactual : le niveau cohérent avec le taux naturel de chômage, la technologie courante et le stock de capital existant. Ce n’est pas le PIB de l’an dernier, ni une prévision de l’année suivante, ni un plafond rigide : la production effective peut dépasser le potentiel en boom et passer en dessous en récession. L’identité du montant est élémentaire : l’écart de PIB égale le PIB effectif moins le PIB potentiel, dans les unités monétaires que vous avez fournies pour les deux niveaux.
L’identité en pourcentage met ce montant à l’échelle du potentiel afin de comparer des économies de tailles différentes : le pourcentage d’écart égale le montant divisé par le PIB potentiel, multiplié par cent. Un montant et un pourcentage positifs signifient que la production effective se situe au-dessus du potentiel ; cette configuration s’appelle écart inflationniste parce que l’excès de demande par rapport à la capacité soutenable tend à faire monter les prix.
Un montant et un pourcentage négatifs signifient que des ressources restent inutilisées ; cette configuration est un écart récessionniste. Lorsque les deux niveaux coïncident, l’écart est zéro et l’économie est dite au potentiel. Le PIB potentiel doit être strictement supérieur à zéro parce que la forme en pourcentage divise par lui ; un potentiel nul ou négatif rendrait le pourcentage indéfini ou économiquement sans sens.
Ce calculateur n’implémente que cette identité à deux nombres : il n’estime pas le potentiel par un filtre HP, une fonction de production ou un modèle DSGE. Vous fournissez un niveau effectif et un niveau potentiel dans les mêmes unités pour la même période, et vous recevez le montant, le pourcentage et une courte étiquette de type, prêts pour les exercices, les tableaux de bord et les contrôles automatisés.
Où un calculateur d’écart de PIB justifie son usage
Les cours de macro d’introduction et de niveau intermédiaire utilisent un calculateur d’écart de PIB pour que les étudiants convertissent toute paire valide d’effectif et de potentiel en le montant et le pourcentage canoniques, sans confondre l’écart de production avec le déflateur du PIB ni avec le taux de croissance d’une année sur l’autre.
Les pages de suivi de politique qui citent un écart inflationniste ou récessionniste peuvent montrer la même identité que le cours, y compris la convention de signe selon laquelle effectif moins potentiel est positif lorsque l’économie s’échauffe. Une validation en échec ne consomme pas de solde.
Gardez le potentiel strictement positif, figez dans les tests le montant et le pourcentage arrondis, et vous obtenez des chiffres reproductibles d’écart de production pour les devoirs, les plugins LMS et les workers en périphérie sans monter vous-même un pipeline complet de comptes nationaux ou de fonction de production.
Utilisez cette capacité lorsque vous avez déjà les deux niveaux ; si vous n’avez que le PIB nominal et le PIB en volume et voulez un indice de prix, c’est l’identité du déflateur du PIB, qui n’appartient pas à cette définition d’écart de production.
Cas d’usage
Contrôles de cours effectif–potentiel
Laissez les étudiants saisir le PIB effectif et le PIB potentiel et vérifier le montant et le pourcentage de l’écart face aux exemples résolus du manuel, y compris les signes inflationniste et récessionniste.
Correction automatique LMS et examens
Notez les items d’écart de production avec un oracle déterministe qui refuse un PIB potentiel nul ou négatif et n’invente jamais Infinity dans la forme en pourcentage.
Carnets macro et tableaux de politique
Calculez en lot les écarts de PIB à partir du PIB effectif publié et d’une série officielle de potentiel, sans dérive des formules de tableur.
Questions fréquentes
Comment calcule-t-on l’écart de PIB ?
Envoyez les deux chiffres dans les mêmes unités de la même période.
Que signifie un écart de PIB positif ?
Un écart positif signifie que le PIB effectif dépasse le potentiel (écart inflationniste). Un écart négatif signifie que l’effectif se situe sous le potentiel (écart récessionniste). Un écart nul signifie que la production est au potentiel.
Pourquoi le PIB potentiel doit-il être supérieur à zéro ?
La forme en pourcentage divise par le PIB potentiel.
En quoi l’écart de PIB diffère-t-il du déflateur du PIB ?
Le déflateur du PIB est un indice de prix (nominal / réel × 100). L’écart de PIB est un écart de quantité : l’éloignement de la production effective par rapport au potentiel, comme montant et comme pourcentage du potentiel.
Que signifie un écart de PIB négatif ?
Que la production se situe sous son potentiel et que du travail et du capital restent inutilisés. On parle d'écart récessif. Avec un PIB effectif de 900 et un potentiel de 1 000, l'écart vaut −100, soit −10 % du potentiel.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/fin/gdp-gap \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"actual_gdp":10500,"potential_gdp":10000}'const res = await fetch("https://api.kit.forhosting.com/fin/gdp-gap", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"actual_gdp": 10500,
"potential_gdp": 10000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/gdp-gap",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"actual_gdp": 10500,
"potential_gdp": 10000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/gdp-gap", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"actual_gdp":10500,"potential_gdp":10000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"actual_gdp":10500,"potential_gdp":10000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/gdp-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"actual_gdp": 10500,
"potential_gdp": 10000
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.gdp_gap",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Contrat d’entrée, champs de réponse et règles de validation
Le PIB effectif doit être un nombre fini ; un effectif nul avec un potentiel positif est un large écart récessionniste, non une erreur de validation. Les champs manquants, les chaînes vides, les valeurs non finies, les booléens et un decimals hors de la plage entière autorisée échouent de la même façon. Associez les nombres à votre propre tableau pluriannuel si vous avez besoin d’une série temporelle d’écarts ; ce point de terminaison calcule uniquement l’écart d’une seule paire effectif–potentiel et n’estime pas le potentiel, ne filtre pas le bruit et ne convertit pas entre PIB nominal et PIB en volume. Conservez les deux chiffres dans les mêmes unités monétaires et la même période afin que la soustraction soit un écart de production, non un instantané mélangé. Envoyez en POST un corps JSON avec deux nombres finis obligatoires : actual_gdp (production observée) et potential_gdp (production soutenable de pleine utilisation de la même période). Envoyez éventuellement decimals comme entier de zéro à douze (défaut six) pour contrôler l’arrondi half-up de gdp_gap et gdp_gap_percent. Le PIB potentiel doit être strictement supérieur à zéro : un potentiel nul ou négatif ferait diviser la forme en pourcentage par un dénominateur non positif, aussi ces requêtes échouent avec invalid_input et ne sont pas facturées. Les alias courants sont acceptés : actual, y, actual_output ou gdp_actual pour actual_gdp ; potential, ystar, y_star, potential_output ou gdp_potential pour potential_gdp. En cas de succès le corps renvoie en écho actual_gdp et potential_gdp, gdp_gap comme effectif moins potentiel, gdp_gap_percent comme ce montant sur le potentiel fois cent, gap_kind comme étiquette pédagogique grossière (inflationary, recessionary ou at_potential), et formula. Exemple : effectif dix mille cinq cents et potentiel dix mille donne gdp_gap cinq cents, gdp_gap_percent cinq et inflationary. Exemple : effectif neuf cents et potentiel mille donne gdp_gap moins cent, gdp_gap_percent moins dix et recessionary. Lorsque les deux niveaux coïncident, les deux chiffres sont zéro et gap_kind vaut at_potential.
Où un calculateur d’écart de PIB justifie son usage
Les générateurs d’examens et les plugins LMS ont besoin d’un oracle déterministe qui rejette un PIB potentiel nul ou négatif au lieu d’inventer Infinity ou un zéro creux qu’un correcteur buggé pourrait traiter comme at_potential. Les carnets d’analystes et les tableaux de bord pédagogiques recomputent souvent les tables des manuels à partir du PIB effectif publié et d’une série officielle de potentiel ; figer l’arithmétique dans une petite API parse évite la dérive des tableurs dans la colonne de comparaison. Comme l’implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.
Questions techniques
Combien coûte le calculateur d’écart de PIB ?
L’outil dans le navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée non valide n’est pas facturée.