Guide de démarrage pour les utilisateurs d'Unhinged Grok
Connectez votre SDK OpenAI existant à notre API LLM sans censure en cinq minutes en mettant à jour l'URL de base et la clé API. Ce guide montre comment envoyer votre première requête en utilisant du code client standard.
Authentification et URL de base
Notre API est compatible OpenAI, ce qui signifie que vous n'avez pas besoin d'une nouvelle bibliothèque. Vous devez uniquement mettre à jour deux valeurs dans votre configuration existante : l'base_url et l'api_key. Votre clé API est générée immédiatement lors de l'inscription via Google ou e-mail. Conservez cette clé en sécurité ; c'est le seul identifiant requis pour l'authentification.
Remplacez l'URL de base OpenAI standard par notre endpoint. Ce changement dirige toutes les requêtes suivantes vers les serveurs de notre modèle sans censure. Aucun autre changement de code n'est requis pour la génération de texte de base.
Exemple de configuration
- URL de base :
https://api.unhingedgrok.com/v1 - Clé API : Votre clé unique depuis le tableau de bord
Vérifiez votre connexion en listant les modèles disponibles. Cela confirme que votre authentification fonctionne correctement avant d'envoyer des requêtes de génération.
Première requête
Commencez par envoyer une requête simple de complétion de texte. Cet exemple utilise curl pour démontrer la structure HTTP brute. La requête cible l'endpoint /v1/chat/completions avec l'ID de modèle uncensored. La réponse renvoie le texte généré dans le tableau choices.
Cette approche directe fonctionne pour n'importe quel langage ou outil qui prend en charge les formats HTTP OpenAI standards. Vous pouvez le tester immédiatement après avoir généré votre clé.
Requête HTTP directe
curl https://api.unhingedgrok.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Intégration SDK Python
Utilisez la bibliothèque Python officielle OpenAI pour intégrer notre API. Installez le package via pip. Initialisez le client avec votre clé et l'URL de base personnalisée. Le reste des méthodes du SDK, comme chat.completions.create, fonctionne exactement comme documenté pour OpenAI.
Cette méthode est idéale pour les services backend, les scripts de traitement de données ou les workflows automatisés. Le SDK gère la sérialisation JSON et l'analyse des réponses automatiquement.
Exemple de code Python
from openai import OpenAI
client = OpenAI(base_url="https://api.unhingedgrok.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Intégration SDK Node.js
Pour les environnements JavaScript ou TypeScript, utilisez le package npm officiel openai. Configurez le client avec la même URL de base et la même clé. Le SDK Node prend en charge les modèles basés sur les callbacks et les promesses.
Cette configuration vous permet d'intégrer la génération de texte sans censure directement dans des applications web, des fonctions serverless ou des outils d'automatisation basés sur Node. La gestion des erreurs reste cohérente avec le comportement standard du SDK OpenAI.
Exemple de code Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unhingedgrok.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Réponses en streaming
Activez la génération de tokens en temps réel en définissant stream: true. L'API renvoie un flux Server-Sent Events (SSE). Chaque chunk contient une réponse partielle. Le dernier chunk inclut les statistiques d'utilisation des tokens.
Le streaming réduit la latence perçue pour les utilisateurs finaux. Il est essentiel pour les interfaces de chat et les applications interactives. Gérez chaque chunk de manière incrémentale pour mettre à jour l'interface utilisateur immédiatement.
Exemple de code de streaming
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Limites, erreurs et contexte
Comprenez les contraintes opérationnelles pour éviter les interruptions de service. La fenêtre de contexte prend en charge 100,000 tokens au total, et si max_tokens n'est pas défini, la réponse peut s'étendre jusqu'à la fin de la fenêtre.
Les limites de débit permettent 300 requêtes par minute par clé. Les requêtes simultanées sont limitées à 8. Les corps de requête ne doivent pas dépasser 8 Mo. Gérez les codes d'erreur HTTP standards : 401 indique une clé invalide, 402 signale un crédit insuffisant et 429 indique une limite de débit atteinte. Les erreurs ne consomment pas de crédit.
Caractéristiques techniques
Toutes les limites et fonctions réelles de l'API au même endroit — vérifiez-les avant de recharger.
| Élément | Valeur |
|---|---|
| Format | compatible OpenAI : tout SDK OpenAI fonctionne en changeant la base URL et la clé |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.unhingedgrok.com/v1 |
| Authentification | Authorization: Bearer YOUR_KEY |
| ID du modèle | uncensored |
| Mode JSON | response_format: {"type": "json_object"} |
| Paramètres | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | oui — server-sent events ; le dernier bloc contient l'usage des tokens |
| Sortie max. | jusqu'au reste de la fenêtre de 100 000 tokens ; max_tokens optionnel (pas de plafond distinct) |
| Fenêtre de contexte | 100 000 tokens (entrée + sortie) |
| Appel de fonctions | oui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool |
| Limite de débit | 300 requêtes par minute et par clé |
| Taille | jusqu'à 8 Mo par requête |
| Concurrence | 8 requêtes simultanées par clé |
| En-têtes | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Bonus | +5 % dès 50 $, +10 % dès 100 $, +15 % dès 200 $ |
| Recharge | USDT (TRC20) ou USDC (Base), tout montant entier de 20 $ à 500 $ |
| Validité | le crédit payé n'expire jamais, sans abonnement |
| Prix | 0,15 $ par million de tokens en entrée · 0,50 $ par million en sortie |
| Essai gratuit | 0,50 $ pendant 7 jours, sans carte · Clé d'essai : 2 requêtes parallèles, 60 par minute ; limites complètes (8 et 300) après la 1re recharge |
| Facturation | crédit prépayé selon l'usage réel ; erreurs et refus gratuits |
| Clés | une clé active par compte ; une nouvelle remplace l'ancienne |
| Connexion | Google ou e-mail et mot de passe |
| Contenu | contenu adulte autorisé ; tout contenu sexuel impliquant des mineurs est refusé |
Erreurs et solutions
Les erreurs arrivent en JSON avec un type stable ; les requêtes échouées ou refusées ne sont pas facturées.
| Code | Type | Signification |
|---|---|---|
400 | bad_request | JSON invalide, messages vides, mauvais paramètre ou contexte trop long |
401 | missing_key · invalid_key · key_revoked | clé absente, erronée ou remplacée |
402 | no_credit | plus de crédit — rechargez, la reprise est immédiate |
403 | content_blocked | contenu sexuel impliquant des mineurs — refusé, non facturé |
404 | not_found | endpoint inconnu |
413 | request_too_large | corps supérieur à 8 Mo |
429 | rate_limited · concurrency | au-delà de 300/min ou 8 en parallèle — patientez |
503 | upstream_busy | modèle occupé — réessayez dans quelques secondes |
Questions et réponses
S'agit-il de l'API officielle Grok ?
Non. Nous sommes un service indépendant hébergeant notre propre modèle sans censure. Nous ne sommes pas affiliés à X Corp ni à l'API officielle Grok. Notre API est compatible avec le format client OpenAI mais exécute un modèle différent.
Comment payer l'utilisation ?
Le crédit est rechargé à l'aide de crypto (USDT sur TRC20 ou USDC sur Base). Le crédit prépayé est facturé en fonction de l'utilisation réelle des tokens. Les erreurs et les refus sont gratuits. Le crédit n'expire jamais.
Quelle est la taille de la fenêtre de contexte ?
Le modèle prend en charge une fenêtre de contexte de 100 000 tokens pour le prompt et la complétion combinés. Il n'y a pas de limite de sortie séparée. Si max_tokens n'est pas spécifié, la réponse peut s'étendre jusqu'à la fin de la fenêtre.
Votre clé n'est qu'à un formulaire d'ici
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.