Documentation de l'API pour les développeurs

URL de base et authentification

Connectez-vous à notre infrastructure en pointant votre client vers l'URL de base désignée et en fournissant votre clé API unique. Nous utilisons une authentification par en-tête standard afin que vous puissiez intégrer notre point de terminaison dans les configurations SDK OpenAI existantes sans réécrire votre logique principale. Vous recevez une clé active par compte, et la génération d'une nouvelle clé invalide immédiatement la précédente. Cette conception garde votre intégration simple tout en maintenant un contrôle d'accès clair. Inscrivez-vous via Google ou e-mail pour voir votre clé instantanément. Nous ne nécessitons pas de numéro de téléphone ni de moyen de paiement pour commencer.

• URL de base : https://api.uncensoreai.com/v1
• En-tête Auth : Authorization: Bearer YOUR_API_KEY

Première demande (POST /v1/chat/completions)

Envoyez votre première complétion en publiant une charge utile JSON sur le point de terminaison des complétions de chat. L'ID du modèle est uncensored et il accepte les structures de messages standard avec les rôles system, user et assistant. Vous obtenez un texte immédiat sans routage complexe ni logique de sélection de modèle. Les erreurs ne consomment pas vos crédits prépayés, vous pouvez donc tester librement. Le modèle gère la génération open-weight optimisée pour le contenu adulte sans refus. Utilisez cette structure pour commencer votre intégration.

Intégration du SDK Python

Utilisez le client Python officiel pour interagir avec notre API en toute transparence. Définissez l'URL de base et la clé API dans votre objet de configuration avant d'effectuer des appels. La bibliothèque gère la sérialisation JSON et l'analyse des réponses pour vous. Vous pouvez accéder aux données d'utilisation directement à partir de l'objet de réponse. Cette approche fonctionne avec n'importe quel environnement Python standard prenant en charge les requêtes asynchrones ou synchrones. Gardez votre clé sécurisée dans les variables d'environnement. L'exemple de code illustre un appel synchrone de base.

Intégration du SDK Node.js

Intégrez avec des projets Node.js en utilisant le gestionnaire de packages standard. Importez le client et configurez l'URL de base pour pointer vers nos serveurs. Le SDK gère les requêtes HTTP et fournit des réponses typées pour les utilisateurs TypeScript. Vous pouvez facilement ajouter des en-têtes ou modifier les délais d'attente si nécessaire. Cette méthode convient aux applications web modernes et aux services backend. Assurez-vous que votre version de Node est compatible avec les exigences du SDK. L'exemple suivant montre une requête de complétion simple.

Réponses en streaming et consommation de jetons

Activer la sortie en temps réel en définissant le stream flag à true dans votre requête. L'API retourne des événements envoyés par le serveur (SSE) au fur et à mesure de la génération des tokens. Vous pouvez afficher du texte aux utilisateurs instantanément sans attendre la réponse complète. Les détails d'utilisation des tokens apparaissent dans le dernier fragment du flux. Cette fonctionnalité réduit la latence perçue pour les sorties longues. Surveillez votre solde de crédit à mesure que les tokens s'accumulent. Le streaming fonctionne avec tous les paramètres standard tels que la température et les séquences d'arrêt.

Limites, Erreurs et Fenêtre de contexte

Votre compte dispose d'une fenêtre de contexte de 100,000 tokens pour le prompt et la complétion combinés. Vous pouvez envoyer jusqu'à 16,000 tokens dans une seule réponse si vous spécifiez max_tokens. La limite de sortie par défaut est de 2 048 tokens si vous omettez ce paramètre. Les limites de débit permettent 300 requêtes par minute et 8 requêtes simultanées par clé. Un statut 401 signifie que votre clé est invalide. Un statut 402 indique un crédit prépayé insuffisant. Un statut 429 signifie que vous avez dépassé la limite de débit. Les corps de requête ne peuvent pas dépasser 8 Mo.

cURL

Copycurl https://api.uncensoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the current server status from the api endpoint"}]
  }'

Python

Copyfrom openai import OpenAI

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