Guide d'intégration : API de complétion de chat

URL de base et authentification

L'API ablité fonctionne comme un remplacement direct des points de terminaison OpenAI standard. Vous acheminez vos requêtes vers https://api.aiabliterated.cc/v1 Et authentifiez-vous à l'aide d'un jeton Bearer dans le Authorization header. Cette configuration fonctionne avec n'importe quel client prenant en charge le protocole OpenAI.

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

L'authentification est stricte. Si vous envoyez une clé invalide, le système renvoie immédiatement une erreur 401.

Le point de terminaison /v1/chat/completions

Envoyez vos données de prompt au /v1/chat/completions point de terminaison pour recevoir des réponses textuelles. Le système attend une charge utile JSON contenant l'identifiant du modèle et votre historique de messages. C'est une interface textuelle uniquement ; ne vous attendez pas à une génération d'images ou d'audio.

Le modèle traite les entrées et les sorties dans une fenêtre de contexte de 100 000 tokens. Si vous ne spécifiez pas de limite, le système génère par défaut 2 048 tokens par requête. Vous pouvez ajuster cette valeur jusqu'à un maximum absolu de 16 000 tokens.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.aiabliterated.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 et consommation de jetons

Activez le streaming en définissant stream: true dans votre charge utile de requête. L'API renvoie un flux Server-Sent Events (SSE) de jetons partiels. Cela réduit considérablement la latence perçue pour les applications interactives.

Les données d'utilisation des tokens ne sont pas envoyées avec chaque chunk. Au lieu de cela, le dernier chunk du flux contient les statistiques d'utilisation complètes pour cette requête. Cette conception garde le flux léger tout en fournissant des données de facturation précises. Les erreurs lors du streaming sont gérées en fermant la connexion avec un objet JSON d'erreur.

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 mode JSON

Le modèle ablité prend en charge les sorties structurées via le response_format paramètre. Définissez ceci sur {"type": "json_object"} pour forcer une conformité JSON stricte. C'est essentiel pour une intégration fiable avec les systèmes backend.

L’appel de fonction est également disponible. Définissez des outils dans votre demande, et le modèle produira un JSON valide correspondant à votre schéma. Le système ne valide pas vos définitions d’outil, alors assurez-vous que vos schémas sont corrects avant d’envoyer des demandes. Cette capacité permet des architectures d’agents complexes sans couches d’analyse externes.

Copyimport OpenAI from "openai";

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

Paramètres : Température, Top-P et Seed

Contrôlez l’aléatoire de vos sorties à l’aide de paramètres d’échantillonnage standards. Le temperature la valeur ajuste la créativité, tandis que top_p limite l'échantillonnage du noyau. Utilisez seed pour des sorties déterministes lorsque vous avez besoin de résultats reproductibles pour le débogage.

D'autres paramètres disponibles incluent stop séquences, presence_penalty, et frequency_penalty. Ceux-ci permettent un contrôle fin de la répétition des tokens et de l'adhésion au sujet. Le modèle sans curation répond bien aux paramètres de température faible pour la génération de code et aux températures élevées pour l'écriture créative.

Limites de débit et contraintes

L'API impose des limites strictes pour garantir la stabilité pour tous les utilisateurs. Vous êtes limité à 300 requêtes par minute par clé. Les requêtes simultanées sont plafonnées à 8 simultanément. Chaque corps de requête ne doit pas dépasser 8 Mo.

Si vous dépassez ces limites, le système renvoie une erreur 429 Too Many Requests. La facturation est basée sur l'utilisation réelle des jetons. Les erreurs et les refus ne consomment pas votre crédit prépayé. Vous pouvez gérer votre clé directement depuis le tableau de bord si vous devez faire tourner les identifiants en raison de ces contraintes.

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'