Référence API

URL de base et authentification

Utilisez l'URL de base dédiée pour toutes les requêtes. Votre clé API authentifie via le Authorization header.

• URL de base : https://api.hereticuncensored.com/v1
• ID du modèle : uncensored

Récupérez votre clé du tableau de bord. Elle est valide immédiatement après sa création.

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

Première demande

Envoyez une simple complétion de chat pour vérifier la connectivité. Le modèle répond sans les filtres de contenu standards pour un usage adulte légal.

• Définir model à uncensored.
• Incluez votre messages tableau.

Vérifiez la réponse pour choices contenant votre texte généré.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticuncensored.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 du SDK Node

Initialisez le client avec l'URL de base et la clé. Cela garantit la compatibilité avec les bibliothèques OpenAI standard.

• Installez l' openai paquet.
• Passer baseURL et apiKey pendre l'initialisation.

Appel chat.completions.create() avec votre invite. La structure de la réponse imite le format de l'API standard.

Copyimport OpenAI from "openai";

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

Activer la livraison de jetons en temps réel en définissant stream à true. Cela réduit la latence perçue pour les longues sorties.

• Écouter delta chunks.
• Combinez les chunks pour reconstituer la réponse complète.

Les métadonnées d'utilisation de tokens apparaissent dans le dernier chunk. C'est idéal pour les interfaces de chat nécessitant une réactivité instantanée.

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)

Limites de débit et contexte

L'API prend en charge une fenêtre de contexte de 100 000 tokens. Vous pouvez envoyer jusqu'à 300 requêtes par minute par clé.

• Requêtes simultanées max : 8
• Tokens de sortie max : 16 000 (2 048 par défaut)

Le dépassement des limites déclenche une erreur 429. Gérez la concurrence pour maintenir un débit constant pour les charges de travail à fort volume.

Gestion des erreurs et codes

Gérez les erreurs avec élégance pour maintenir la stabilité de l'application. Les codes courants incluent 401 pour les clés invalides et 402 pour le crédit insuffisant.

• 429 indique une épuisement de la limite de débit.
• 400 signale des corps de requête mal formés.

Les remboursements ne sont pas émis pour les tokens consommés. Vérifiez régulièrement votre solde pour éviter les interruptions de service.