Intégration étape par étape de l'API LLM uncensored.com
L'intégration d'un LLM non censoré dans votre application nécessite une configuration précise de l'URL de base et des en-têtes d'authentification. Ce guide vous accompagne dans la mise en place de l'API uncensored.com pour la génération de texte, le streaming et l'utilisation d'outils à l'aide de SDK compatibles OpenAI standards.
Dernière mise à jour
Résumé
- L'API utilise l'URL de base HTTPS://api.uncensoredaicom.com/v1 et l'ID de modèle "uncensored" pour toutes les requêtes.
- L'authentification est gérée via un jeton Bearer dans l'en-tête Authorization, obtenu après s'être inscrit avec Google ou email.
- Les réponses en streaming sont activées en définissant stream=true, délivrant les jetons via Server-Sent Events.
- La tarification est transparente à 0,15 $ par million de jetons d'entrée et 0,50 $ par million de jetons de sortie, avec un crédit crypto prépayé qui n'expire jamais.
Prérequis : SDK et configuration de l'environnement
Installez le SDK du langage préféré pour communiquer avec le point de terminaison. La plupart des développeurs utilisent le SDK officiel OpenAI pour Python, Node.js ou Go. Cela fonctionne car l'API suit le schéma standard de complétion de chat OpenAI.
Assurez-vous que votre environnement dispose de Python 3.8+ ou Node.js 18+. Installez le package via pip ou npm. Vous aurez besoin d'une clé API depuis le tableau de bord. Aucun numéro de téléphone n'est requis pour l'inscription.
- Python :
pip install openai - Node.js :
npm install openai
Conservez votre clé API dans une variable d'environnement. Cela évite une exposition accidentnelle dans le contrôle de version. La clé donne accès au modèle uncensored.
Configuration de l'URL de base
Pointez votre client SDK vers l'URL de base correcte. C'est l'étape la plus critique pour une intégration réussie. L'URL de base OpenAI par défaut ne fonctionnera pas pour ce service.
Définissez l'URL de base sur HTTPS://api.uncensoredaicom.com/v1. Cela dirige les requêtes vers l'infrastructure LLM uncensored. L'ID de modèle que vous devez envoyer est "uncensored". C'est un modèle à poids ouverts ajusté pour minimiser les refus.
Vérifiez la connexion en appelant le point de terminaison des modèles. Cela confirme que vos identifiants et votre URL de base sont corrects. Une réponse réussie renvoie l'ID du modèle et le type d'objet.
Authentification et configuration des en-têtes
Transmettez votre clé API dans l'en-tête Authorization. Utilisez le schéma Bearer pour toutes les requêtes. Cet en-tête authentifie votre compte de crédit prépayé.
Définissez l'en-tête comme suit : Authorization: Bearer YOUR_API_KEY. Le SDK gère cela automatiquement si vous transmettez la clé au constructeur du client. Assurez-vous qu'aucun espace blanc supplémentaire n'est inclus. Les clés invalides renvoient une erreur 401 Unauthorized.
Vous bénéficiez d'une clé active par compte. La génération d'une nouvelle clé invalide la précédente. Cela simplifie la rotation et la gestion de la sécurité. Gardez votre clé en sécurité dans votre environnement de déploiement.
Envoi d'une demande de chat standard
Faites une requête POST vers /v1/chat/completions. Envoyez vos messages sous forme de tableau d'objets role et content. Le système prend en charge les rôles user, assistant et system.
Structure d'exemple : {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. L'API renvoie une complétion de texte. La fenêtre de contexte est de 100 000 jetons au total. La sortie maximale est de 16 000 jetons par requête.
Les erreurs et les refus ne consomment pas de crédit. Cela protège votre solde prépayé. Réglez temperature et top_p pour le contrôle. Les valeurs par défaut fonctionnent pour la plupart des cas d'utilisation.
Activation du streaming pour les sorties en temps réel
Définir stream: true dans le corps de votre requête. Cela active les événements envoyés par le serveur (SSE). Les jetons arrivent de manière incrémentale au lieu d'attendre la complétion complète.
Analysez le flux SSE pour afficher le texte en temps réel. Le dernier chunk contient les statistiques d'utilisation des tokens. Cela permet un suivi précis de la facturation. Le streaming réduit la latence perçue pour les utilisateurs finaux.
Gérez les interruptions réseau avec élégance. Reconnectez-vous si le flux se coupe. L'API uncensored prend en charge le streaming stable. Surveillez l'état de la connexion. Utilisez ceci pour les interfaces de chat ou la génération de texte long.
L'utilisation des outils et de l'appel de fonctions
Définissez les outils dans le corps de votre requête. Transmettez une liste de schémas de fonctions. Le modèle peut appeler ces fonctions en fonction de l'intention de l'utilisateur. Cela permet un comportement de type agent.
Specify tool_choice pour contrôler la sélection de fonction. Utilisez auto pour la détection automatique. L'API prend en charge les définitions standard d'outils. Analysez les arguments d'appel de fonction à partir de la réponse.
Implémentez l'exécution de la fonction dans votre code. Envoyez le résultat en tant que message. Le modèle poursuit la conversation. Cela permet des flux de travail complexes. Les tests garantissent une analyse précise des arguments.
Gestion des réponses en mode JSON
Définir response_format: {"type": "json_object"}. Cela force le modèle à produire du JSON valide. Utilisez ceci pour l'extraction de données structurées. Cela empêche les erreurs de réponse mal formée.
Analysez la chaîne JSON dans votre code. Gérez les erreurs de parsing potentielles. Le mode JSON améliore la fiabilité pour les intégrations API. Il est idéal pour les pipelines de traitement de données.
Combinez le mode JSON avec les prompts système. Guidez le modèle pour qu'il produise des schémas spécifiques. Cela garantit un formatage cohérent. Validez la sortie avant de l'utiliser. Cela réduit les erreurs en aval.
Surveillance des limites et des erreurs
Respectez les limites de débit. Vous disposez de 300 requêtes par minute par clé. Maximum 8 requêtes concurrentes. La taille du corps de la requête est limitée à 8 Mo.
Surveillez les codes de statut HTTP. 429 indique une limite de taux dépassée. 400 indique une mauvaise requête. 500 indique une erreur serveur. Implémentez une réessaye exponentielle pour les nouvelles tentatives. Cela empêche de surcharger l'API.
Suivez l'utilisation des tokens dans le dernier fragment de streaming. Cela aide à gérer votre crédit prépayé. Les erreurs ne consomment pas de tokens. Cela protège votre solde. Une surveillance régulière garantit un fonctionnement fluide.
Calcul des coûts et de l'utilisation des jetons
La tarification est transparente et prépayée. Les tokens d'entrée coûtent 0,15 $ par million. Les tokens de sortie coûtent 0,50 $ par million. Le crédit n'expire jamais. Aucun frais mensuel ne s'applique.
Rechargez avec de la crypto uniquement. USDT (TRC20) ou USDC (Base). Les montants varient de 20 $ à 500 $. Un crédit bonus s'applique pour les recharges plus importantes. +5 % à partir de 50 $, +10 % à partir de 100 $, +15 % à partir de 200 $.
Calculez les coûts avant une utilisation intensive. Estimez les comptes de jetons pour vos invites. Cela aide à budgétiser efficacement. Les erreurs sont gratuites. Les remboursements ne sont pas émis, mais les erreurs sont corrigées. Utilisez le tableau de bord pour suivre les dépenses.
Questions fréquemment posées
uncensoredai.com est-il compatible avec le SDK OpenAI ?
Oui, l'API est entièrement compatible avec OpenAI. Vous pouvez utiliser les SDK OpenAI standard pour Python, Node.js et d'autres langages. Modifiez simplement l'URL de base vers HTTPS://api.uncensoredaicom.com/v1 et transmettez votre clé API. L'ID du modèle est "uncensored". Il suit la même structure de requête et de réponse.
Quels paiements crypto sont acceptés ?
Nous acceptons les USDT sur le réseau TRC20 et les USDC sur le réseau Base. Vous pouvez recharger n'importe quel montant entier entre 20 $ et 500 $. Un crédit bonus est ajouté automatiquement : +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $.
Le crédit prépayé expire-t-il ?
Non, votre crédit prépayé n’expire jamais. Il n’y a pas de frais d’abonnement mensuels ni de délais d’utilisation. Vous payez ce que vous utilisez, et les erreurs ne consomment pas de crédit. Ce modèle garantit que vous ne payez que pour la valeur réelle reçue.
Puis-je utiliser cette API pour du contenu NSFW ?
Oui, le modèle est sans censorship et ne refuse pas les sujets adultes, fictifs ou controversés légaux. Il est conçu pour la génération de texte sans restriction. La seule limite stricte concerne le contenu impliquant des mineurs, qui est toujours refusé. Il est idéal pour les chatbots NSFW et l'écriture créative.
Générez votre clé API
Inscrivez-vous, récupérez la clé, mettez à jour l'endpoint. Configuration minimale requise.
