Documentation API

Authentification et URL de base

L'API nécessite une clé API unique pour l'authentification. Vous recevez cette clé immédiatement après vous être inscrit avec Google ou une adresse e-mail. Transmettez-la dans le Authorization en-tête en tant que jeton Bearer. L'URL de base est https://api.topuncensored.com/v1. Cette URL fonctionne avec n'importe quel SDK ou bibliothèque client compatible OpenAI.

• Utilisez l’en-tête : Authorization: Bearer YOUR_API_KEY
• Définissez l'URL de base de votre client sur le point de terminaison fourni.

Cette configuration garantit que vous pouvez échanger les bibliothèques sans modifier votre logique principale.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Point de terminaison Chat Completions

Envoyez des prompts textuels au /v1/chat/completions endpoint. L'ID du modèle est uncensored. Ce point de terminaison gère le formatage standard des messages de chat. Il renvoie directement des réponses textuelles. Il n’y a pas de couches supplémentaires ni de wrappers. Vous contrôlez la fenêtre de contexte de 100 000 tokens. Les requêtes de moins de 8 Mo fonctionnent de manière fiable. Utilisez ceci pour la génération de texte directe.

Structurez votre requête avec un prompt system et un message user. Le modèle répond sans filtrer le contenu adulte légal. Les erreurs comme les clés manquantes retournent 401. Plus de crédit ? Vous obtenez une erreur 402. Ce sont des signaux clairs.

Réponses en streaming

Activez le streaming en définissant stream: true. Vous recevez des chunks de texte au fur et à mesure de leur génération. Cela réduit la latence perçue pour les sorties longues. Le dernier chunk inclut les données d'utilisation des tokens. Utilisez cela pour des affichages en temps réel ou un rendu progressif. C'est efficace pour les applications à fort volume.

Analysez chaque chunk pour construire votre réponse finale. Cette méthode gère les grandes sorties avec élégance. L'API prend en charge les événements envoyés par le serveur (SSE) standard. C'est l'approche recommandée pour les applications interactives.

Copyfrom openai import OpenAI

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

Appel d'outils et mode JSON

Utiliser l'appel de fonctions pour des interactions structurées. Définissez les outils dans votre requête. Le modèle renvoie des arguments structurés. Définissez response_format à {"type": "json_object"} pour une sortie JSON stricte. Cela garantit des formats de données prévisibles. Combinez ces fonctionnalités pour des intégrations robustes. Vous obtenez un contrôle précis sur la structure de la sortie.

L'appel d'outils fonctionne avec le schéma standard OpenAI. Le mode JSON force un JSON valide. Utilisez-les pour les intégrations API ou l'extraction de données. Cette flexibilité prend en charge des workflows complexes.

Copyimport OpenAI from "openai";

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

Paramètres et limites

Ajuster temperature, top_p, et stop séquences. Définissez max_tokens vers 16 000. La valeur par défaut est de 2 048 si elle est omise. Contrôlez la répétition avec presence_penalty et frequency_penalty. Utilisez seed pour des sorties déterministes. Ces paramètres affinent la qualité de la génération. Vous avez un contrôle total sur le style de sortie.

Les limites de débit sont de 300 requêtes par minute. Les requêtes simultanées sont limitées à 8. Ces limites garantissent des performances stables. Surveillez votre utilisation via le tableau de bord. Ajustez les paramètres pour optimiser votre cas d'utilisation spécifique.

Erreurs et fenêtre de contexte

Gérez les erreurs avec élégance. 401 signifie une clé invalide. 402 indique un crédit insuffisant. 429 signale les limites de taux. La fenêtre de contexte est de 100 000 tokens au total. La sortie maximale est de 16 000 tokens. Gérez vos tokens avec sagesse. Les erreurs ne consomment pas de crédit. Cela permet d'économiser de l'argent pendant le débogage. Utilisez le dernier chunk pour les statistiques d'utilisation.

Suivez votre utilisation des jetons. Évitez de dépasser les limites de taux. Réessayez avec une backoff exponentielle. Cela garantit un fonctionnement fiable. L'API est conçue pour la robustesse. Gérez les erreurs comme faisant partie du flux normal.

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)