Comment créer une clé API Grok, plus une alternative

Création d'une clé avec le fournisseur

Nous sommes un service indépendant et non l'API officielle xAI ; pour la clé propre à xAI, utilisez les pages de xAI. Le processus est similaire à celui de la plupart des fournisseurs, mais les noms des menus peuvent différer de ceux décrits ci-dessous.

1. Connectez-vous à la console développeur du fournisseur avec votre compte.
2. Vérifiez la section facturation. Certains fournisseurs exigent un moyen de paiement ou un dépôt avant qu'une clé ne fonctionne ; lisez les conditions spécifiques à votre compte.
3. Ouvrez la section clés API et choisissez de créer une nouvelle clé.
4. Donnez-lui un nom indiquant son utilisation, comme le projet ou l'environnement.
5. Copiez la clé immédiatement. De nombreuses consoles n'affichent le secret complet qu'une seule fois.
6. Stockez-la dans un gestionnaire de secrets ou une variable d'environnement, jamais dans le code source.

Si la mise en page de la page ne correspond pas, la documentation du fournisseur fait autorité. Tout guide écrit il y a plusieurs mois, y compris celui-ci, peut décrire une interface plus ancienne.

Obtention d'une clé en moins d'une minute

Notre clé s'adresse à un endpoint compatible OpenAI servant un modèle à poids ouverts hébergé, optimisé pour répondre sans refus de contenu pour un usage adulte légal. L'obtention prend cinq étapes.

1. Ouvrez la page clé API.
2. Inscrivez-vous avec Google, ou avec une adresse e-mail et un mot de passe.
3. Cliquez une fois pour obtenir votre $0,50 de crédit d'essai. Il s'agit d'un par personne, valable 7 jours, et ne nécessite aucune carte.
4. Copiez la clé affichée sur la page.
5. Exécutez l'appel de test ci-dessous.

L'URL de base est https://api.grokaiapikey.com/v1, l'ID du modèle est uncensored, et la clé s'insère dans l'en-tête Authorization: Bearer.

Tester la clé

Commencez avec curl. Si cela renvoie une réponse JSON, votre clé, votre URL de base et votre modèle sont corrects.

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

En Node, le package officiel OpenAI fonctionne après que vous ayez modifié deux paramètres.

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.grokaiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

Les utilisateurs Python peuvent faire de même avec OpenAI(base_url=..., api_key=...). Les méthodes disponibles sont POST /v1/chat/completions, POST /v1/responses et GET /v1/models.

Définir la clé comme variable d'environnement

Ne collez jamais une clé dans le code source. Placez-la dans une variable d'environnement et lisez-la au moment de l'exécution. Les commandes varient selon le système.

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

Pour un projet, stockez la valeur dans un fichier .env qui est listé dans .gitignore, et chargez-le avec le chargeur de votre framework. Sur un serveur, utilisez le magasin de secrets de l'hôte ou les paramètres d'environnement de la plateforme de déploiement. L'URL de base de ce site est https://api.grokaiapikey.com/v1, et il est sûr de la conserver dans le code car elle n'est pas secrète.

Si vous exécutez plusieurs services, attribuez une clé à chacun. Les comptes qui ont été rechargés peuvent détenir jusqu'à 5 clés, donc une copie de staging, une copie de production et une clé de test personnelle peuvent toutes coexister, chacune avec son étiquette.

En cas d'échec de l'appel

Symptôme	Cause probable	Correction
401 Non autorisé	Clé manquante ou mal tapée	Vérifiez l'en-tête Bearer et recherchez un espace ou un guillemet final
404 Non trouvé	URL de base incorrecte	Le chemin doit être /v1/chat/completions sur le sous-domaine api.
Erreur du modèle	Nom de modèle incorrect	Utilisez l'ID du modèle uncensored
429 rate_limited	Trop de requêtes par minute	Les clés d'essai permettent 60 par minute ; ralentissez
429 concurrency	Trop de requêtes simultanées	Les clés d'essai permettent 2 requêtes en vol ; un flux maintient son emplacement jusqu'à sa fin

Un code 429 avec un en-tête Retry-After: 5 indique une surcharge temporaire. Attendez cinq secondes et réessayez.

Utilisez l'ID de requête

Chaque réponse inclut un X-Request-Id en-tête. Notez-le à côté de votre message d'erreur. Si vous contactez l'équipe support au sujet d'un appel échoué, l'ID de requête leur permet de retrouver cet appel exact au lieu de deviner. Avec curl, ajoutez -i pour afficher les en-têtes de réponse, et dans le SDK Python, vous pouvez les lire via l'assistant de réponse brute.

En cas de problème intermittent, les en-têtes aident aussi : X-RateLimit-Limit-Requests et X-RateLimit-Limit-Concurrency indiquent les limites applicables à votre clé, ce qui permet de voir en un coup d'œil si vous utilisez une clé d'essai ou complète.

Remplacement ou ajout de clés

Vous n'avez jamais besoin de demander à quelqu'un de faire tourner une clé. Sur la page des clés API, vous pouvez régénérer (réémettre) la clé à tout moment, et l'ancienne devient immédiatement inactive. Faites-le dès qu'une clé se retrouve dans un dépôt public, une capture d'écran ou un chat partagé.

Les comptes qui ont rechargé peuvent conserver jusqu’à 5 clés. Attribuez à chacune une étiquette, telle que préproduction ou application mobile, et révoquez n’importe quelle clé sans toucher aux autres. Utiliser une clé par environnement est une bonne pratique, car la révocation d’une clé de préproduction compromise n’affecte alors pas votre trafic de production.

Utilisation de la clé dans des outils existants

Vous n'avez pas besoin d'écrire du code pour utiliser la clé. De nombreuses interfaces de chat et outils développeurs acceptent un endpoint compatible OpenAI personnalisé, et SillyTavern est un exemple public. La configuration demande toujours les mêmes trois valeurs.

• URL de base ou URL API : https://api.grokaiapikey.com/v1
• Clé API : la clé que vous avez copiée
• Nom du modèle : uncensored

Certains outils veulent le chemin complet se terminant par /chat/completions ; d'autres l'ajoutent eux-mêmes. Si vous obtenez une 404, essayez l'autre forme. Si la liste déroulante du modèle reste vide, tapez le nom du modèle à la main, ou laissez-la récupérer la liste depuis GET /v1/models, qui renvoie l'ID du modèle unique.

Le streaming fonctionne via les mêmes paramètres. Si les réponses apparaissent d'un coup au lieu de mot par mot, recherchez une option de streaming dans l’outil.

Sécuriser une clé

• Conservez-la côté serveur. Une clé placée dans du JavaScript côté navigateur ou dans un bundle d'application mobile peut être lue par n'importe qui.
• Chargez-le depuis une variable d'environnement et ajoutez votre fichier env à .gitignore avant le premier commit.
• Définissez une habitude de dépense : surveillez l'en-tête de réponse X-Balance-USD pour qu'une baisse inattendue se remarque.
• Utilisez des clés distinctes pour des services distincts afin de pouvoir révoquer l'une sans provoquer d'indisponibilité ailleurs.

Une fois l'appel de test réussi, lisez la documentation sur le streaming, l'appel de fonctions et le mode JSON, et consultez la page des tarifs pour les taux : 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie. Si vous comparez cela à un fournisseur propriétaire, notre article sur pourquoi les développeurs passent à des modèles sans censure couvre les compromis.

Une routine de rotation simple

1. Sur la page des clés API, créez ou régénérez la clé que vous souhaitez remplacer. La régénération fait cesser immédiatement le fonctionnement de l'ancienne clé, alors faites-le lorsque votre code est prêt à utiliser la nouvelle valeur.
2. Mettez à jour la variable d'environnement ou le secret à chaque endroit où la clé est utilisée.
3. Redémarrez le service et exécutez le test curl de cet article.
4. Notez la date dans vos notes. Un rappel de calendrier tous les quelques mois suffit pour la plupart des projets.

Si vous détenez plusieurs clés étiquetées après un rechargement, faites-les tourner une par une. Révoquez d'abord la clé liée à un ordinateur portable ou à un ancien collègue, car ce sont les plus susceptibles d'être compromises.

Plus de guides

• Clé API Grok gratuite : ce qui est réel et ce qui est une arnaque
• Clé API Claude : pourquoi les développeurs passent à des modèles sans censure