Documentation de l'API : Guide de démarrage rapide

URL de base et authentification

L'API Heretic AI est entièrement compatible OpenAI. Vous interagissez avec elle en pointant votre client vers notre URL de base : https://api.hereticai.cc/v1. L'authentification repose sur une seule clé API par compte, générée instantanément lors de l'inscription via Google ou e-mail. Passez cette clé dans le Authorization en-tête en tant que jeton Bearer. L'identifiant du modèle est simplement uncensored. Ce modèle unique gère toutes vos requêtes sans complexité de routage. Les erreurs telles que 401 indiquent une clé invalide, tandis que 402 signifie que vous avez besoin de plus de crédit crypto prépayé.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Point de terminaison Chat Completions

Envoyez des requêtes de génération de texte en utilisant POST /v1/chat/completions point de terminaison. L'API attend un tableau de messages standard contenant l'historique de votre conversation ou votre invite. Elle renvoie du texte généré dans le choices tableau. Il s'agit d'une API purement utilitaire : texte en entrée, texte en sortie. Vous ne payez que pour les tokens consommés. Le crédit prépayé n'expire jamais, et les refus ou erreurs ne coûtent pas de tokens. Cette approche élimine les abonnements verrouillés et les niveaux gratuits imprévisibles.

Copyfrom openai import OpenAI

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

Réponses en streaming (SSE)

Activez le streaming de jetons en temps réel en définissant stream: true dans votre requête. L'API renvoie des Server-Sent Events (SSE) pour chaque token généré. Cela vous permet d'afficher la sortie de manière progressive, ce qui est crucial pour les applications sensibles à la latence. Les statistiques d'utilisation des tokens apparaissent dans le dernier chunk du flux. Cette fonctionnalité fonctionne de manière transparente avec les SDK OpenAI standard qui gèrent automatiquement les SSE. Elle fournit une réactivité immédiate sans attendre la complétion complète.

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)

Appel de fonction et outils

L'API prend en charge l'appel de fonctions avec le tools et tool_choice paramètres. Définissez les schémas de vos outils dans la requête, et le modèle renverra des appels de fonction structurés lorsque cela est approprié. Cela permet des workflows complexes où le LLM décide de l'action suivante à entreprendre. Vous pouvez imposer une utilisation spécifique d'outils ou laisser le modèle choisir librement. Cette capacité est essentielle pour créer des applications agentic qui interagissent avec des systèmes externes ou des bases de données.

Mode JSON

Assurez une sortie déterministe en définissant response_format à {"type": "json_object"}. Le modèle limitera sa réponse à du JSON valide, ce qui est vital pour l'analyse programmée. Cela réduit le besoin de corrections de regex post-traitement. Il garantit que la sortie peut être consommée directement par votre code. Cela est particulièrement utile pour l'extraction de données structurées ou la génération de configurations.

Paramètres et limites

Maîtrisez la génération avec des paramètres standards tels que temperature, top_p, et seed. La fenêtre de contexte est de 100 000 tokens pour l'invite plus la complétion. La sortie maximale est de 16 000 tokens par requête, ou 2 048 si max_tokens n'est pas défini. Les limites de débit sont de 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. Ces limites garantissent une utilisation stable à fort volume pour les développeurs.

Node.js

Copyimport OpenAI from "openai";

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