Démarrage rapide API et intégration

URL de base et authentification

Le Projet Heretic fournit un point de terminaison hébergé unique pour la génération de texte. Utilisez https://api.hereticproject.com/v1 comme votre URL de base. L'authentification repose sur un jeton porteur transmis via le Authorization header. Créez votre clé en vous connectant avec Google ou e-mail sur le tableau de bord. Le système émet une clé active par compte ; la génération d'une nouvelle clé invalide immédiatement la précédente.

Vous ne payez que les tokens consommés. Les erreurs et les refus ne débitent pas votre crédit prépayé. Un nouveau compte reçoit 0,50 $ de crédit d'essai valable sept jours. Vous rechargez en utilisant USDT (TRC20) ou USDC (Base) en montants compris entre 20 $ et 500 $.

Le point de terminaison /v1/chat/completions

Envoyez des messages au point de terminaison standard de complétion de chat. L'ID du modèle est uncensored. Il accepte une liste d'objets de messages avec des rôles comme system, user, ou assistant. Le modèle ne refuse pas les sujets adultes, fictifs ou controversés légaux. C'est un modèle à poids ouverts ajusté pour des réponses directes.

Les requêtes retournent un objet JSON contenant le texte généré. La fenêtre de contexte prend en charge 100 000 jetons combinés pour l'invite et la complétion. La sortie est limitée à 16 000 jetons par requête sauf si vous spécifiez une valeur inférieure max_tokens la valeur.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Intégration du SDK Python

Utilisez la bibliothèque Python officielle d'OpenAI avec une URL de base personnalisée. Définissez api_key à votre chaîne API. Configurez base_url pour pointer vers le serveur du Heretic Project. Cela vous permet d'utiliser des méthodes familières comme chat.completions.create() sans modifier significativement la structure de votre code existant.

Installez la bibliothèque via pip. Transmettez vos identifiants directement à l'initialisation du client. La bibliothèque gère automatiquement la sérialisation. Cette approche fonctionne pour les flux de travail synchrones et asynchrones. Assurez-vous de gérer les erreurs réseau potentielles de manière élégante.

Copyfrom openai import OpenAI

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

Le SDK Node.js fonctionne de manière identique à la version Python. Initialisez le client avec votre clé API et l'URL de base correcte. Vous pouvez envoyer des requêtes de complétion en utilisant les mêmes signatures de méthode. Cela garantit la cohérence entre les différentes parties de votre pile technique.

Gérez les réponses de manière asynchrone. Le SDK diffuse les données si vous utilisez la méthode de streaming. Sinon, il renvoie la réponse JSON complète. Cette flexibilité prend en charge à la fois le traitement par lots et les interfaces en temps réel. Gardez votre clé API en sécurité dans les variables d'environnement.

Copyimport OpenAI from "openai";

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

Activez le streaming en définissant stream: true dans votre requête. Le serveur envoie des Server-Sent Events (SSE). Chaque chunk contient des mises à jour de texte partiel. Cela réduit la latence perçue pour les utilisateurs finaux. Les données d'utilisation des tokens apparaissent dans le dernier chunk du flux.

Traitez chaque objet delta pour accumuler la réponse complète. Arrêtez d'écouter lorsque le flux se ferme ou qu'une erreur se produit. Cette méthode est idéale pour les interfaces de chat. Elle permet aux utilisateurs de voir les pensées se former en temps réel. La surcharge est minime par rapport aux réponses complètes.

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, Erreurs et Contexte

Respectez les limites de débit pour éviter les interruptions de service. Vous avez droit à 300 requêtes par minute par clé. La concurrence est limitée à 8 requêtes simultanées. Le corps de la requête ne peut pas dépasser 8 Mo. Le dépassement de ces limites renvoie un code de statut 429. Attendez brièvement avant de réessayer.

Les échecs d'authentification retournent une erreur 401. Cela se produit si la clé est invalide ou expirée. Une erreur 402 indique un crédit prépayé insuffisant. Les erreurs de remboursement sont gérées via la page Support. Le crédit n'expire jamais. Le modèle refuse le contenu impliquant des mineurs. Tout autre contenu légal est accepté.