GroqAiApiGuide de démarrage rapide API LLM sans censure
Guide de démarrage rapide API LLM sans censure
Ce guide montre aux développeurs comment intégrer notre API LLM sans censure à l'aide de bibliothèques compatibles OpenAI standard. Vous apprendrez à vous authentifier, à envoyer des requêtes et à gérer le streaming via notre endpoint direct.
Prérequis : votre clé API et URL de base
Commencez par générer votre groq ai api key via la page Obtenir la clé API. Vous pouvez vous connecter avec Google ou utiliser un e-mail et un mot de passe pour recevoir vos identifiants instantanément. Aucun numéro de téléphone n'est requis pour ce processus.
Définissez votre URL de base sur https://api.groqaiapikey.com/v1 dans la configuration de votre client. Ce point de terminaison prend en charge les SDK OpenAI standard, vous permettant de changer de fournisseur sans réécrire la logique d'intégration. Vous n'avez besoin que d'une clé active par compte, car la génération d'une nouvelle clé remplace immédiatement la clé précédente.
Première demande : Envoi d'une invite à /v1/chat/completions
Envoyez une requête POST à /v1/chat/completions en utilisant votre clé dans le Authorization header. L'identifiant du modèle est simplement uncensored, qui traite les entrées de texte et retourne des sorties de texte sans refus de contenu pour un usage adulte légal.
Assurez-vous de définir le Content-Type header correctement pour éviter les erreurs 404 courantes. Notre API ne prend pas en charge les embeddings, la génération d'images ou le traitement audio, donc concentrez vos payloads sur les complétions de chat. Cette approche directe vous garantit un prix transparent des jetons sans les frais de proxy multi-fournisseurs.
Installez le SDK : bibliothèques compatibles OpenAI
Installez le package Python officiel OpenAI pour interagir avec notre point de terminaison en utilisant des méthodes familières. Cette bibliothèque gère l'authentification et la sérialisation JSON automatiquement lorsque vous la pointez vers notre URL de base. Vous pouvez utiliser la même structure de code que vous utiliseriez pour GPT-4, mais avec notre modèle uncensored.
Pour les développeurs JavaScript, installez le openai Package Node.js. Les deux environnements vous permettent de remplacer facilement l'URL de base. Cette compatibilité signifie que vous pouvez passer d'un fournisseur de LLM à un autre en modifiant simplement deux lignes de configuration dans votre code.
Gestion du streaming : SSE et utilisation des tokens
Activez le streaming en définissant stream: true dans les paramètres de votre requête. L'API renvoie des Server-Sent Events (SSE) qui délivrent les jetons de manière incrémentale au fur et à mesure de leur génération. Cela réduit la latence perçue pour les utilisateurs attendant des réponses longues.
Les statistiques d'utilisation des tokens sont incluses uniquement dans le dernier chunk du flux. Vous devez accumuler ces deltas pour calculer le nombre total de tokens consommés à des fins de facturation. Les erreurs et les refus ne génèrent pas de frais, vous pouvez donc streamer en toute sécurité sans vous soucier des coûts inattendus pour les requêtes échouées.
Paramètres avancés : Température, mode JSON et outils
Utiliser temperature et top_p pour contrôler l'aléatoire et la créativité dans vos réponses. Définissez response_format à {"type": "json_object"} pour forcer une sortie JSON structurée afin d'obtenir une analyse fiable dans vos applications. C'est essentiel pour construire des APIs de chatbot NSFW robustes ou des outils d'extraction de données.
Activer l'appel de fonctions en fournissant un tools tableau. Le modèle prend en charge les définitions d'outils standard et peut choisir d'appeler des fonctions en fonction du contexte de votre invite. Vous pouvez également définir max_tokens vers 16 000, qui est la sortie maximale par requête. La fenêtre de contexte prend en charge 100 000 jetons au total, y compris le prompt et la complétion.
Limites, erreurs et spécificités de facturation
Attendez une erreur 401 si votre clé est invalide, une erreur 402 si vous avez un crédit prépayé insuffisant et une erreur 429 si vous dépassez la limite de débit. Vous êtes limité à 300 requêtes par minute et 8 requêtes simultanées par clé. Le corps de la requête doit rester inférieur à 8 Mo.
Les prix sont de 0,15 $ par 1M de tokens d'entrée et de 0,50 $ par 1M de tokens de sortie. Les recharges sont uniquement en crypto (USDT sur TRC20 ou USDC sur Base) de 20 $ à 500 $. Vous recevez un bonus de 5 % à 50 $, 10 % à 100 $ et 15 % à 200 $. Votre crédit prépayé n'expire jamais, vous pouvez donc l'utiliser quand vous en avez besoin.
cURL
curl https://api.groqaiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current API rate limit?"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.groqaiapikey.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groqaiapikey.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);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)Questions fréquemment posées
Comment obtenir ma clé API Groq AI ?
Accédez à la page Obtenir la clé API et connectez-vous avec Google ou une adresse e-mail. Votre clé s'affiche immédiatement après l'inscription, sans numéro de téléphone requis. Vous pouvez générer une nouvelle clé à tout moment pour remplacer l'ancienne.
Cette API est-elle compatible avec les SDK OpenAI ?
Oui, notre point de terminaison suit le protocole de complétion de chat OpenAI. Vous pouvez utiliser les bibliothèques Python et Node.js officielles d'OpenAI en modifiant simplement l'URL de base vers l'adresse de notre API. Cela vous permet d'utiliser des paramètres standard comme temperature et stream.
Que se passe-t-il si j'obtiens une erreur 402 ?
Une erreur 402 signifie que votre crédit prépayé est épuisé. Vous pouvez recharger en utilisant USDT sur TRC20 ou USDC sur Base via le tableau de bord. Les recharges démarrent à 20 $, et vous recevez du crédit bonus en fonction du montant déposé.
Obtenez votre clé API
Inscrivez-vous, récupérez la clé, et mettez à jour votre URL de base. C'est tout ce qui est requis pour la configuration.