Documentation

Visibilité IA : vos propres clés API

Obtenez une clé API pour chaque modèle d'IA et ajoutez-la à CrunchJunkie, ou évitez la configuration avec Managed AI.

Deux façons d'alimenter la Visibilité IA

La Visibilité IA interroge chaque modèle d'IA pour votre compte, ce qui exige une clé API pour ce modèle. Vous avez deux options. Avec Managed AI, CrunchJunkie fournit les clés : nous exécutons les modèles sur nos propres clés de plateforme, mesurés par vérification dans le cadre d'un pack Managed AI mensuel (à partir de 25 €/mois, 0,05 €/vérification en dépassement), sans rien à configurer. Ou bien vous apportez votre propre clé API pour chaque modèle et payez directement le fournisseur. Vous pouvez mélanger les deux et changer à tout moment, par exemple en utilisant votre propre clé OpenAI mais Managed AI pour le reste. Dans les deux cas, les clés sont stockées chiffrées (AES-256-GCM). Elles exécutent vos scans, et une clé OpenAI, Claude ou Gemini alimente aussi les fonctions IA de Crunch (résumés de rapport, Ask Crunch, briefs de contenu), sauf si vous ajoutez une clé d'assistant distincte ; les clés Grok et DeepSeek n'exécutent que des scans. Sur Managed AI, ces fonctions s'exécutent sur Claude avec la clé Anthropic de CrunchJunkie. Les sections ci-dessous montrent comment obtenir votre propre clé auprès de chaque fournisseur.

OpenAI : ChatGPT

Créez un compte sur platform.openai.com. IMPORTANT : l'accès à l'API OpenAI est payable à l'usage et facturé SÉPARÉMENT de tout abonnement ChatGPT : un forfait ChatGPT Plus, Team ou Business n'inclut PAS l'accès à l'API, et son identifiant/ses clés ne fonctionneront pas ici. C'est l'erreur la plus courante. Commencez donc, sous Settings → Billing sur platform.openai.com, par ajouter un moyen de paiement et un peu de crédit. Ouvrez ensuite platform.openai.com/api-keys, cliquez sur « Create new secret key », nommez-la « CrunchJunkie » et copiez-la : elle n'est affichée qu'une seule fois. Collez-la dans CrunchJunkie. Lorsque vous connectez une clé, CrunchJunkie lance un vrai test rapide de chaque fonction que la clé alimente et rejette sur-le-champ une clé sans crédit ni facturation : vous ne croyez ainsi jamais être prêt alors que vous ne l'êtes pas. Les réglages dont une clé a besoin, et ce que coûte le test, figurent dans la section suivante. Une clé valide alimente à la fois le modèle de visibilité ChatGPT (actuellement GPT-5.6 Luna avec recherche web) et l'IA propre de CrunchJunkie (résumés de rapport et assistant Crunch, sur GPT-5.6 Terra). Si vous préférez ne pas configurer la facturation OpenAI du tout, une clé Claude ou Gemini fonctionne tout aussi bien pour CrunchJunkie AI, ou utilisez Managed AI.

Utiliser votre propre clé OpenAI

Une clé OpenAI exécute jusqu'à trois choses ici, chacune sur son propre point d'accès et son propre modèle : les scans de Visibilité IA (l'API Responses, modèle gpt-5.6-luna), CrunchJunkie AI (Chat Completions, modèle gpt-5.6-terra) et la transcription vocale (le point d'accès audio, modèle whisper-1). Lorsque vous connectez la clé, CrunchJunkie teste chacun d'eux et affiche le résultat par fonction. La clé est enregistrée pour les fonctions qui marchent, et une fonction qu'OpenAI refuse affiche la raison d'OpenAI et l'endroit où corriger. Quatre réglages décident du résultat. Permissions. Une clé dont les permissions sont réglées sur All fonctionne. Une clé Restricted a besoin de Model capabilities: Request, qui couvre les trois points d'accès appelés par le test et les fonctions : Responses (Write) pour les scans, Chat completions pour CrunchJunkie AI et Audio pour la transcription vocale. Réglez d'abord Model capabilities sur Request, puis désactivez ce dont vous n'avez pas besoin, car cocher seulement un sous-élément a pu omettre la permission de requête elle-même. Vous pouvez modifier les permissions d'une clé existante sur platform.openai.com → API keys → modifier la clé → Permissions ; aucune nouvelle clé n'est nécessaire. Lorsqu'OpenAI refuse pour une permission manquante, CrunchJunkie nomme celle qu'OpenAI signale, par exemple Responses: Write. Si la clé est réglée sur All et qu'OpenAI signale quand même une permission manquante, le propriétaire de la clé doit avoir un rôle de projet autorisé à faire des requêtes (Member ou Owner). Crédit et facturation. L'usage de l'API est facturé par OpenAI séparément de ChatGPT (voir plus haut). L'organisation a besoin d'un crédit ou d'un moyen de paiement sous Settings → Billing, et une limite de dépense que vous fixez pour l'organisation ou le projet arrête la clé une fois atteinte. Modèles autorisés. Si le projet de la clé limite les modèles qu'il peut utiliser (Settings → votre projet → Limits → Model usage), autorisez gpt-5.6-luna pour les scans et gpt-5.6-terra pour CrunchJunkie AI. OpenAI réserve certains modèles aux organisations vérifiées ; si c'est le cas, vérifiez sous Settings → Organization → General → Verify Organization. OpenAI indique que l'accès peut mettre jusqu'à 15 minutes à arriver ensuite. Pas de liste d'adresses IP autorisées. Les adresses de nos serveurs changent : un projet ou une organisation qui n'accepte les requêtes que depuis des adresses IP listées refuse donc toutes les requêtes que nous envoyons. Utilisez une clé d'un projet sans liste d'adresses IP autorisées. Ce que coûte le test. Une minuscule requête par fonction, facturée par OpenAI au compte de la clé : une requête Responses vers gpt-5.6-luna plafonnée à 16 jetons de sortie et sans recherche web, une requête Chat Completions vers gpt-5.6-terra, également plafonnée à 16 jetons de sortie, et, lorsque la clé exécute aussi CrunchJunkie AI, une demi-seconde de silence audio pour whisper-1. Au total, cela représente bien moins d'un dixième de centime de dollar américain. Les clés des autres fournisseurs sont aussi vérifiées par une minuscule génération réelle, et un refus nomme la raison du fournisseur. Les causes et corrections pour Gemini se trouvent sous Google : Gemini. Une clé Anthropic a besoin de crédit sous Plan & Billing sur console.anthropic.com, et une limite de dépense mensuelle que vous y fixez l'arrête une fois atteinte. Perplexity donne la même réponse pour une clé invalide et pour un compte sans crédit : vérifiez donc les deux lorsqu'il refuse une clé.

Google : Gemini

Rendez-vous sur aistudio.google.com et connectez-vous avec un compte Google. Ouvrez aistudio.google.com/apikey (« Get API key ») et cliquez sur « Create API key ». Gemini propose un niveau gratuit pour démarrer ; pour des limites de débit plus élevées et un ancrage par recherche web fiable, liez un projet Google Cloud dont la facturation est activée. Copiez la clé et collez-la dans CrunchJunkie. Elle alimente le modèle Gemini (recherche web). Lorsque vous connectez une clé Gemini, CrunchJunkie lance une minuscule génération réelle avec le modèle qu'il utilise pour scanner, et si Google la refuse, il vous donne la raison réelle de Google plutôt qu'une supposition. Une clé peut être refusée pour des raisons qui n'ont rien à voir avec la clé elle-même : une clé toute neuve n'est donc pas une garantie. Les causes habituelles : la clé a été coupée lors de la copie ; le projet Google Cloud de la clé a un compte de facturation désactivé, fermé ou pas entièrement configuré (BILLING_DISABLED) ; le crédit prépayé de ce compte de facturation est à 0 $ (HTTP 402, qui arrête toutes les clés du compte) ; l'API Generative Language est désactivée dans le projet (SERVICE_DISABLED) ; la clé a une restriction d'application (sites web, adresses IP ou applications) qui bloque les requêtes de nos serveurs, ou des restrictions d'API qui excluent l'API Generative Language ; Google refuse la requête avec FAILED_PRECONDITION, que Google rattache à la facturation ; ou Google a bloqué tout le projet (« Your project has been denied access »). Pour les problèmes de facturation, terminez le compte de facturation dans Google AI Studio → Billing, ou dissociez le projet de celui-ci (Google indique que le projet revient alors au niveau gratuit), ou créez la clé dans un projet sans facturation. Pour un projet bloqué, ouvrez-le dans Google AI Studio et suivez sa bannière ; une nouvelle clé dans le même compte Google obtient généralement la même réponse. Pour une restriction de clé, retirez ou assouplissez uniquement la restriction d'application (adresses IP, sites web ou applications), car les adresses de nos serveurs ne sont pas fixes, et conservez la restriction d'API de la clé (« Restrict to Gemini API only » dans Google AI Studio → API Keys) : Google rejette les clés standard non restreintes. Une clé que Google ne fait que limiter en débit est enregistrée, avec une note. Une cause tient à l'ancienneté de la clé : depuis septembre 2026, Google rejette les clés « standard » non restreintes, et les clés créées dans Google AI Studio depuis le 28 mai 2026 sont du type plus récent. Si donc Google dit qu'une clé n'est « pas valide » et qu'elle a été créée avant cette date, restreignez-la avec « Restrict to Gemini API only » dans Google AI Studio → API Keys (Google continue d'accepter les clés standard restreintes), ou créez une nouvelle clé sur aistudio.google.com/apikey et remplacez l'ancienne dans Paramètres → Clés IA et API. Rien d'autre ne change, et votre historique reste. La même raison apparaît sous « À vérifier » sur l'Accueil lorsqu'un scan échoue avec votre clé. Managed AI n'est pas concerné.

Perplexity

Connectez-vous sur perplexity.ai et ouvrez Settings → API (perplexity.ai/settings/api). Ajoutez un moyen de paiement ou achetez des crédits (l'accès à l'API est facturé séparément d'un abonnement Perplexity Pro), puis générez une clé API et copiez-la. Collez-la dans CrunchJunkie. Elle alimente les scans de visibilité Perplexity, qui passent par l'Agent API de Perplexity avec sa recherche web et ses citations.

Anthropic : Claude

Créez un compte sur console.anthropic.com et ajoutez la facturation/des crédits sous Plan & Billing. Allez ensuite dans Settings → API Keys (console.anthropic.com/settings/keys), créez une clé et copiez-la. Collez-la dans CrunchJunkie. Elle alimente le modèle Claude (recherche web).

xAI : Grok

Connectez-vous sur console.x.ai avec votre compte X / xAI, ajoutez la facturation, puis ouvrez la section API Keys, créez une clé et copiez-la. Collez-la dans CrunchJunkie. Elle alimente le modèle Grok (recherche web).

DeepSeek

Créez un compte sur platform.deepseek.com et rechargez votre solde sous Billing / Top up. Ouvrez la section des clés API, créez une clé et copiez-la. Collez-la dans CrunchJunkie. Elle alimente le modèle DeepSeek.

SerpAPI : Google AI Overviews et AI Mode

Les réponses de Google AI Overviews et AI Mode sont lues via SerpAPI plutôt que par une API de modèle directe. Inscrivez-vous sur serpapi.com et trouvez votre clé sur le tableau de bord (serpapi.com/manage-api-key) : un quota mensuel de recherches gratuit est proposé, avec des forfaits payants pour un volume supérieur. Collez la clé dans CrunchJunkie. Elle alimente les modèles Google AI Overviews et Google AI Mode. Chaque vérification utilise une recherche SerpAPI, sauf un AI Overview que Google charge en deux étapes : SerpAPI le récupère par une seconde requête et la facture comme une seconde recherche, de sorte que ces vérifications en utilisent deux. Quels aperçus se chargent ainsi, on ne le sait qu'à leur exécution. Rarement, la première réponse vient du cache de SerpAPI avec un lien vers l'aperçu qui a déjà expiré ; la vérification interroge alors une fois de plus sans le cache, et utilise jusqu'à quatre recherches. L'export d'utilisation IA (Paramètres → Facturation) indique les recherches utilisées par chaque vérification, dans la colonne serpapi_searches, de sorte que le compte peut être rapproché de votre tableau de bord SerpAPI.

Où ajouter vos clés dans CrunchJunkie

Toutes les clés API se trouvent au même endroit : Paramètres → Clés IA et API. Collez une fois la clé de chaque fournisseur, puis choisissez ce qu'elle alimente avec les interrupteurs à côté : « Utiliser pour le suivi de visibilité IA » (scanner ce modèle) et, pour les fournisseurs qui exécutent aussi l'IA propre de CrunchJunkie (OpenAI, Anthropic, Gemini), « Activer CrunchJunkie AI » (résumés de rapport, détection d'anomalies et assistant Crunch). Une seule clé OpenAI peut donc piloter à la fois vos scans de visibilité ChatGPT et vos résumés de rapport : inutile de la saisir deux fois. Les clés sont chiffrées au repos (AES-256-GCM) et utilisées uniquement aux fins que vous activez ; vous pouvez en supprimer une à tout moment. Lorsque vous connectez une clé, CrunchJunkie lance une minuscule génération réelle et, si le fournisseur la refuse, dit pourquoi dans votre langue : la clé n'est pas valide, le compte n'a ni crédit ni facturation, la clé n'a pas une permission, son projet ne peut pas utiliser le modèle, l'organisation doit d'abord être vérifiée, le fournisseur ne fait que la limiter en débit (la clé est alors enregistrée, avec une note), ou le fournisseur n'a pas pu être joint. Lorsque la réponse du fournisseur ne correspond à aucun de ces cas, vous voyez ses propres mots. Une clé OpenAI est testée par fonction, comme décrit dans Utiliser votre propre clé OpenAI. Si une clé expire plus tard ou n'a plus de crédit, elle est signalée sous « À vérifier » sur l'Accueil, afin qu'un scan n'échoue jamais en silence. Connecter une clé n'ajoute son modèle à aucun projet : les Moteurs à suivre de chaque projet décident de ce que ses scans interrogent. Après avoir connecté une clé pour la visibilité IA, la page propose d'ajouter son moteur aux projets qui ne le suivent pas encore ; rien ne change tant que vous ne cliquez pas, et rien ne s'exécute avant le prochain scan de chaque projet, sur votre clé. Vous préférez ne gérer aucune clé ? Activez Managed AI pour n'importe quel modèle et nous l'exécuterons sur notre clé pour un prix mensuel fixe.