Documentation API

Authentification et URL de base

Commencez par générer votre clé via le tableau de bord. Utilisez l'URL de base https://api.grokapipricing.com/v1 pour toutes les requêtes. Définissez le Authorization header pour Bearer YOUR_API_KEY. Une seule clé fonctionne sur tous les points de terminaison. Faites-la tourner librement si nécessaire.

POST /v1/chat/completions

Envoyez vos prompts au point de terminaison de chat. L'ID du modèle est toujours uncensored. Configurez des paramètres comme temperature ou top_p pour contrôler la créativité. Les réponses retournent des complétions de chat standard avec des métadonnées d'utilisation des tokens. Les erreurs comme 402 ou 429 indiquent des problèmes de facturation ou de taux.

GET /v1/models

Vérifier les modèles disponibles en envoyant une requête GET au point de terminaison des modèles. Vous verrez le uncensored le modèle répertorié. Cela confirme la connectivité et la disponibilité du modèle. Utilisez ceci pour déboguer les configurations client avant d'envoyer des charges utiles lourdes.

Utilisation du streaming et des SSE

Activez le streaming en définissant stream: true dans le corps de votre requête. L'API renvoie des événements envoyés par le serveur (SSE) pour la livraison de jetons en temps réel. Les statistiques d'utilisation des jetons apparaissent dans le dernier fragment du flux. Cela réduit la latence perçue pour les réponses longues.

Appel de fonction et mode JSON

Utiliser response_format avec {"type": "json_object"} pour des sorties JSON strictes. Activez l'appel de fonctions en définissant tools dans votre requête. Le modèle prend en charge tool_choice pour une exécution forcée ou automatique. Cela garantit une intégration fiable avec la logique de votre backend.

Limites de débit et contraintes

Vous êtes limité à 300 requêtes par minute par clé. La concurrence est plafonnée à 8 requêtes simultanées. La taille maximale du corps de la requête est de 8 Mo. La fenêtre de contexte permet 100 000 tokens au total. Les requêtes dépassant ces limites reçoivent immédiatement des erreurs 429 ou 400.

cURL

Copycurl https://api.grokapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run query and return rows"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokapipricing.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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokapipricing.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

Copystream = 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)