Documentation de l'API Hermes : Démarrage rapide

Installation et configuration

L'API hermes fonctionne avec n'importe quel client qui utilise le format OpenAI. Vous avez besoin d'une URL de base et d'une clé API. Créez un compte via Google ou e-mail sur la page Obtenir la clé API. Le système affiche votre clé immédiatement. Aucun numéro de téléphone n'est requis. Vous recevez un crédit d'essai de 0,50 $ pendant sept jours. Rechargez plus tard uniquement avec de la crypto.

• URL de base : HTTPS://api.apihermes.cc/v1
• En-tête Auth : Authorization: Bearer YOUR_API_KEY
• ID du modèle : uncensored

Installez votre SDK préféré et définissez l'URL de base. Le point de terminaison attend des paramètres standard de complétion de chat. Gardez votre clé en sécurité. Une clé remplace la précédente si vous en générez une nouvelle.

Requête de complétion de chat basique

Une requête de base envoie des messages et reçoit une réponse textuelle. L'ID du modèle est uncensored. Il gère le contenu adulte légal sans refus. Vous payez par token utilisé. Les erreurs et les refus ne coûtent rien. La fenêtre de contexte contient 100 000 tokens au total.

Structurez votre requête avec un message system et un message user. L'API retourne une complétion. Vous pouvez définir max_tokens pour contrôler la longueur de la sortie. La limite de sortie par défaut est de 2 048 tokens. Vous pouvez augmenter cela à 16 000 tokens par requête. Le streaming fonctionne via SSE. L'appel de fonctions est disponible. Le mode JSON est pris en charge.

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

Le corps de la requête est limité à 8 Mo. Les limites de débit sont de 300 requêtes par minute. La concurrence est de huit requêtes simultanées. La logique de retry gère gracieusement la surcharge du serveur.

Réponses en streaming avec SSE

Le streaming délivre les jetons au fur et à mesure de leur génération. Le serveur envoie des Server-Sent Events. Chaque chunk contient du texte partiel. Le dernier chunk inclut les statistiques d'utilisation des jetons. Cette approche réduit la latence perçue pour les réponses longues. Elle est idéale pour les interfaces de chat. Vous devez gérer le flux correctement. Des déconnexions peuvent survenir. L'API ne garantit pas l'ordre de livraison au-delà du flux lui-même.

Définissez le paramètre stream sur true. Analysez les lignes de données. Concaténez le contenu. Vérifiez le finish_reason pour la complétion. Le modèle uncensored fonctionne avec n'importe quel SDK compatible OpenAI. Configurez le client pour gérer les SSE. Surveillez le nombre de jetons. L'URL de base reste la même. L'authentification est identique. Aucune configuration supplémentaire n'est nécessaire.

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)

Les erreurs apparaissent dans le flux. Gérez-les en fermant la connexion. Le crédit prépayé ne se déduit que pour les jetons complétés. Cela permet d'économiser de l'argent en cas d'interruption. Vous ne payez jamais pour une sortie partielle de qualité médiocre. Le système est transparent.

L'utilisation de l'appel de fonctions et des outils

L'appel de fonction permet au modèle d'exécuter du code ou des outils. Définissez des outils dans le corps de la requête. Le modèle renvoie un appel d'outil. Vous exécutez l'outil. Vous renvoyez le résultat. Le modèle génère une réponse finale. Cela permet des workflows complexes. Ce n'est pas seulement un wrapper de chat. L'API prend en charge les outils et tool_choice. Utilisez ceci pour les agents ou l'automatisation.

Structurez le tableau d'outils. Incluez le nom, la description et les paramètres. Le modèle décide quand appeler un outil. Vous devez analyser les arguments. Exécutez la fonction. Transmettez la sortie à la conversation. Le modèle continue. Ce cycle se répète jusqu'à la réponse finale. La fenêtre de contexte suit toutes les interactions avec les outils. Suivez l'utilisation des tokens. Les coûts s'accumulent avec les sorties des outils. Surveillez l'utilisation dans le dernier chunk.

Copyfrom openai import OpenAI

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

Le modèle sans censure gère divers schémas d'outils. Il ne refuse pas en fonction du contenu. Utilisez-le pour le jeu de rôle ou les tâches techniques. L'API est fiable. Les erreurs sont absentes. Le système prépayé garantit l'équité. Vous contrôlez le flux. L'URL de base est cohérente. L'authentification est simple.

Mode JSON et paramètres

Le mode JSON force le modèle à sortir du JSON valide. Définissez response_format sur json_object. Cela est utile pour les données structurées. Le modèle évite les enveloppes markdown. Il renvoie du JSON brut. Utilisez cela pour l'analyse. Cela améliore la fiabilité. La fenêtre de contexte s'applique toujours. Vous payez pour les jetons. Le modèle uncensored respecte le format. Il ne refuse pas en fonction du contenu.

Les paramètres incluent la température, le top_p, les séquences d'arrêt, la graine, la pénalité de présence et la pénalité de fréquence. La température contrôle l'aléatoire. Le top_p contrôle la diversité. Les séquences d'arrêt arrêtent la génération. La graine assure la reproductibilité. Les pénalités de présence et de fréquence ajustent l'utilisation des jetons. Définissez-les pour affiner la sortie. L'API prend en charge tous les paramètres standard. Utilisez-les pour ajuster la réponse. L'URL de base reste la même. L'authentification est identique.

Copyimport OpenAI from "openai";

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

Les erreurs sont gérées via les codes de statut HTTP. 401 signifie clé invalide. 402 signifie pas de crédit. 429 signifie limite de débit. Gérez-les dans votre code. Le crédit prépayé n'est déduit que pour les jetons complétés. Cela garantit l'équité. Vous ne payez jamais pour une sortie partielle. Le système est transparent. Le modèle uncensored est fiable. Utilisez-le pour toute tâche légale.

Gestion des erreurs et limites de débit

L'API renvoie des codes d'état HTTP standard. 401 indique une clé API invalide. 402 indique un crédit prépayé insuffisant. 429 indique une limite de débit. La limite est de 300 requêtes par minute. La concurrence est de huit requêtes à la fois. Les corps de requête sont limités à 8 Mo. Gérez ces erreurs avec élégance. Réessayez avec une rétrogradation exponentielle. Le modèle uncensored ne refuse pas le contenu licite. Les erreurs sont gratuites. Vous ne payez pas pour les requêtes échouées. Le crédit prépayé est sécurisé. Il n'expire jamais. Utilisez la page Support pour les doubles facturations. Crypto uniquement. USDT ou USDC. Des bonus s'appliquent.