Première requête en cinq minutes

URL de base et authentification

Notre API reproduit l'interface OpenAI v1, vous permettant de changer d'endpoints sans modifier la logique de votre application. Utilisez https://api.groknsfw.top/v1 comme URL de base. L'authentification nécessite une clé API valide transmise dans l'en-tête Authorization sous forme de jeton Bearer. Vous pouvez générer cette clé instantanément via la connexion Google ou par e-mail sur le tableau de bord. Chaque compte prend en charge une seule clé active à la fois ; l'émission d'une nouvelle clé invalide immédiatement la précédente. Ce modèle à clé unique simplifie le contrôle d'accès pour la plupart des environnements de développement et de QA.

Première requête

Envoyez une requête standard de complétion de chat pour tester la connectivité. L'identifiant du modèle est uncensored, qui gère les refus de contenu différemment des modèles standards. Voici un exemple de base utilisant l'outil en ligne de commande curl pour vérifier que votre clé et votre URL de base sont corrects.

Copycurl https://api.groknsfw.top/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."}]
  }'

Si vous recevez une réponse JSON avec choices et usage, votre intégration est active. Consultez l'objet usage pour voir la consommation de tokens et suivre la facturation avec précision.

Intégration du SDK Python

Utilisez le package Python officiel openai pour interagir avec notre endpoint. Définissez les attributs base_url et api_key avant d'effectuer des appels. Cette approche fonctionne avec toute bibliothèque prenant en charge le schéma OpenAI, rendant la migration depuis d'autres fournisseurs simple.

Copyfrom openai import OpenAI

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

Cet extrait illustre une requête synchrone. Pour la génération de contenu NSFW à haut débit, envisagez d'utiliser des clients asynchrones pour gérer plusieurs requêtes simultanément sans bloquer votre thread principal.

Configuration du SDK Node.js

Pour les applications JavaScript ou TypeScript, configurez le SDK OpenAI pour pointer vers notre URL de base. Cela garantit que votre code client existant fonctionne sans modification. L'écosystème Node.js bénéficie de cette compatibilité, permettant un prototypage rapide des interfaces de chat NSFW.

Copyimport OpenAI from "openai";

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

Assurez-vous d'utiliser une version récente du SDK qui prend en charge les URL de base personnalisées. L'objet de configuration doit inclure strictement les propriétés apiKey et baseURL pour éviter les incompatibilités d'endpoint.

Réponses en streaming (SSE)

Activez la génération de tokens en temps réel en définissant stream: true dans votre requête. L'API retourne un flux Server-Sent Events (SSE), délivrant les tokens au fur et à mesure de leur génération. Cela réduit la latence perçue pour les utilisateurs finaux dans les applications de chat.

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)

Analysez les événements SSE pour extraire le contenu delta. Le dernier fragment du flux contient les statistiques totales usage, que vous devez utiliser pour la réconciliation comptable précise. Le streaming n'affecte ni le comptage des tokens ni la tarification.

Limites, erreurs et contexte

Vos requêtes sont soumises à une limite de 300 par minute et de 8 requêtes simultanées par clé. La taille maximale du corps de la requête est de 8 Mo, et la fenêtre de contexte prend en charge jusqu'à 100 000 tokens au total. Les erreurs sont renvoyées au format HTTP standard : 401 pour les clés invalides, 402 pour un crédit insuffisant, et 429 pour les limites de débit. Les erreurs de crédit sont gratuites, mais les limites de débit vous obligent à réduire le débit des requêtes. Le nombre maximal de tokens en sortie par requête est de 32 000 ; l'omission de max_tokens vaut par défaut 2 048 tokens.