Documentation API

Authentification et URL de base

L'API nécessite un jeton porteur pour chaque requête. Générez votre clé sur la page Obtenir la clé API en vous connectant avec Google ou un mot de passe par e-mail. La clé apparaît immédiatement sans vérification par téléphone. Utilisez l'URL de base https://api.uncensoredaigithub.com/v1 avec les SDK officiels d'OpenAI en mettant à jour le base_url et api_key les valeurs. Cette configuration fonctionne avec n'importe quel client compatible OpenAI.

Point de terminaison : https://api.uncensoredaigithub.com/v1

En-tête Auth : Authorization: Bearer YOUR_API_KEY

Chaque compte prend en charge une clé active. L'émission d'une nouvelle clé invalide automatiquement la précédente. Cela empêche la dérive des jetons lorsque vous faites tourner les identifiants sur différents environnements.

Point de terminaison Chat Completions

Envoyez des requêtes textuelles au /v1/chat/completions point de terminaison utilisant l'ID du modèle uncensored. L'API accepte les messages de chat standard et renvoie des réponses textuelles sans filtres de contenu pour l'usage adulte licite. Vous pouvez configurer des paramètres comme temperature, top_p, et stop pour contrôler la créativité et la longueur de la sortie.

La fenêtre de contexte permet jusqu'à 100 000 tokens pour l'invite et la complétion combinées. Définissez max_tokens pour contrôler la sortie, avec une valeur par défaut de 2 048 tokens si omis. Les erreurs et les refus ne consomment pas de crédit, vous pouvez donc tester en toute sécurité.

Réponses en streaming et consommation

Activez le streaming en définissant stream: true dans votre requête. L'API renvoie des Server-Sent Events (SSE) contenant des chunks de texte partiels. Les données d'utilisation des tokens n'apparaissent que dans le dernier chunk du flux. Cela permet un rendu en temps réel des réponses tout en suivant précisément la consommation.

Le streaming est idéal pour les applications de jeu de rôle ou la génération de contenu de longue forme. Vous pouvez analyser le flux SSE pour mettre à jour l'interface utilisateur de manière incrémentale. L'API garantit que les métriques d'utilisation restent précises même si la connexion se coupe prématurément.

Appel de fonction et outils

Prenez en charge l'appel de fonctions en fournissant un tools tableau dans la requête. Le modèle peut retourner des appels d'outils structurés avec des arguments. Utilisez tool_choice pour imposer des comportements spécifiques, tels que l'exécution automatique de fonctions. Cette fonctionnalité permet l'intégration avec des services externes ou une logique personnalisée.

Définissez des fonctions avec des noms, des descriptions et des schémas de paramètres. L'API renvoie le nom de la fonction et les arguments dans la réponse. Analysez ces arguments pour exécuter votre code personnalisé. Cette capacité rend l'API LLM uncensored adaptée aux workflows complexes d'agents.

Mode JSON et paramètres

Forcez une sortie structurée en définissant response_format à {"type": "json_object"}. Le modèle renverra du JSON au lieu de texte brut. Cela est utile pour l'extraction de données ou la génération de configurations. Combinez cela avec l'appel de fonctions pour des intégrations API robustes.

D'autres paramètres pris en charge incluent seed pour des sorties déterministes, presence_penalty, et frequency_penalty. Utilisez seed pour reproduire des réponses spécifiques afin de déboguer. Ajustez les pénalités pour réduire les répétitions ou encourager un vocabulaire diversifié dans vos sorties.

Gestion des erreurs et limites

L'API impose une limite de débit de 300 requêtes par minute et de 8 requêtes simultanées par clé. Les corps de requête ne doivent pas dépasser 8 Mo. Si vous dépassez ces limites, vous recevez un code d'état 429. Les échecs d'authentification renvoient une erreur 401. Un solde insuffisant déclenche une erreur 402.

Le crédit est facturé en fonction de l'utilisation réelle des tokens. Le crédit prépayé n'expire jamais, vous n'avez donc pas à vous soucier des renouvellements mensuels. Utilisez la page Support pour résoudre les problèmes tels que les doubles facturations.

cURL

Copycurl https://api.uncensoredaigithub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the unit tests for the new auth module."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)