FAQ Uncensored API

Les bases

Qu'est-ce que Uncensored API en une phrase ?

C'est un endpoint de complétions de chat payant et texte uniquement qui sert un seul modèle, id uncensored, et qui ne refuse pas le contenu adulte légal, la fiction ou les sujets controversés.

Quelle URL dois-je appeler ?

Utilisez https://api.uncensoredapis.com/v1 comme base. Les requêtes de chat vont vers POST /v1/chat/completions et la liste des modèles se trouve à GET /v1/models. Tout autre chemin renvoie 404.

Dois-je apprendre un nouveau SDK ?

Non. Les formes de requête et de réponse suivent la convention courante des complétions de chat, donc les packages Python et Node officiels fonctionnent une fois que vous avez changé l'URL de base et la clé. curl fonctionne aussi, comme le montrent les docs.

Existe-t-il un moyen d'essayer avant de payer ?

Oui. Un nouveau compte reçoit 0,50 $ de crédit d'essai, valable 7 jours, et aucun moyen de paiement n'est demandé lors de l'inscription. Inscrivez-vous avec un e-mail et un mot de passe sur la page clé et la clé apparaît immédiatement.

Puis-je choisir parmi plusieurs modèles ?

Non. Il y a exactement un modèle, et son id est uncensored. Un appel à la route des modèles renvoie cette entrée unique, donc il n'y a rien à sélectionner ou à basculer.

À qui ce service est-il destiné ?

Aux développeurs qui créent des produits pour adultes, y compris des outils de fiction, des applications de jeu de rôle et des assistants de recherche. Vous êtes responsable de vos propres vérifications d'âge et règles de contenu dans ce que vous déployez par-dessus.

Clés et accès

Combien de clés un compte obtient-il ?

Une seule. Si vous avez besoin d'une nouvelle valeur, régénérez-la depuis le compte ; la clé précédente cesse de fonctionner au même moment, donc déployez le remplacement immédiatement.

Où doit se trouver la clé ?

Conservez-la dans une variable d'environnement ou un gestionnaire de secrets sur un serveur que vous contrôlez. Le JavaScript du navigateur et les binaires mobiles peuvent être inspectés, donc acheminez le trafic client via votre propre backend au lieu d'intégrer la clé.

Comment la clé est-elle envoyée ?

Dans un en-tête Authorization: Bearer à chaque requête. Une valeur manquante ou incorrecte renvoie 401 avec un objet d'erreur JSON.

Je veux une clé API sans censure pour une équipe. Peut-on la partager ?

Vous le pouvez, mais chaque processus partage la même allocation de 300 requêtes par minute et le même solde. Placez une petite passerelle devant la clé et donnez à chaque collègue l'accès à la passerelle plutôt qu'à la clé elle-même.

Limites et tarification

Quelle taille peut avoir un prompt ?

La fenêtre de contexte est de 100 000 tokens, partagée par le prompt et la complétion. Le corps d'une seule requête ne peut pas dépasser 8 Mo. Une requête dont le prompt plus max_tokens dépasserait la fenêtre est rejetée avec un 400.

Quelle est la longueur maximale d'une réponse ?

La valeur par défaut est de 2048 tokens. Vous pouvez augmenter max_tokens jusqu'à 32 000 par requête. Lorsqu'une réponse s'arrête en raison du plafond, finish_reason vaut length.

Combien cela coûte-t-il ?

Les tokens d'entrée sont à 0,25 $ par million et les tokens de sortie à 1,00 $ par million. Le solde est prépayé, il n'y a pas d'abonnement, et le solde n'expire jamais. Consultez la page de tarification pour le tableau.

Pouvez-vous donner une estimation rapide ?

Supposons un tour de chat avec 1 500 tokens de prompt et 300 tokens de complétion, purement à titre d'illustration. Cela représente 0,000375 $ pour l'entrée plus 0,0003 $ pour la sortie, soit environ 0,000675 $ par tour, donc 1 $ achète environ 1 480 tours de ce type.

Que se passe-t-il lorsque j'envoie trop de requêtes ?

Chaque clé peut effectuer 300 requêtes par minute. Au-delà, vous obtenez un 429, et la bonne réponse est de ralentir et de réessayer avec un délai.

Questions d'intégration

Quels paramètres d'échantillonnage puis-je définir ?

Les paramètres standards tels que temperature, top_p et stop sont transmis à la génération. Définissez-les dans le corps de la requête exactement comme vous le feriez ailleurs.

L'API se souvient-elle des tours de conversation précédents ?

Non. Chaque requête est indépendante, vous devez donc renvoyer la conversation dans messages à chaque fois. Supprimez les tours les plus anciens lorsque le total approche de la fenêtre de 100 000 tokens.

Puis-je diffuser des tokens vers un navigateur ?

Oui, envoyez stream: true et lisez les événements envoyés par le serveur (SSE). Faites-le depuis votre backend et relayez le texte vers la page, afin que la clé n'atteigne jamais le client.

Un message système est-il pris en charge ?

Oui. Placez un message avec le rôle system en premier dans le tableau pour définir le ton, le format et les limites de la conversation.

Que dois-je vérifier en premier lorsque la sortie semble tronquée ?

Lisez finish_reason. Une valeur de length signifie que la limite a été atteinte, augmentez alors max_tokens ou réduisez le prompt. La liste reference répertorie toutes les valeurs.

Solde et facturation

Comment ajouter des fonds ?

Rechargez votre solde prépayé depuis votre compte. Il n'y a pas d'abonnement à souscrire, et le solde inutilisé reste disponible car il n'expire jamais.

Que se passe-t-il lorsque le crédit d'essai est épuisé ?

Le crédit d'essai est valable 7 jours. Une fois dépensé ou expiré, les requêtes retournent un code 402 avec le code no_credit jusqu'à ce que vous rechargiez le solde.

Puis-je voir le coût d'une requête ?

Chaque réponse inclut un bloc usage avec les tokens du prompt, de la complétion et le total. Multipliez par les tarifs par million de tokens pour obtenir la charge, et tenez votre propre comptabilité si vous souhaitez un registre.

Les requêtes échouées sont-elles gratuites à réessayer ?

La nouvelle tentative est autorisée, mais restez raisonnable. Utilisez un délai de réessai court pour les 429 et 503 et ne bouclez jamais sur les 400, 401, 402 ou 403, car ils ne se corrigeront pas. Le guide erreurs propose une politique prête à l'emploi.

Contenu et comportement

Que ne fera pas le modèle ?

Le contenu adulte légal n'est pas refusé, ni la fiction ni les sujets controversés. L'exception absolue concerne tout contenu sexuel impliquant des mineurs, qui est bloqué systématiquement avec un code 403, y compris dans les histoires et le jeu de rôle. Le service est destiné aux adultes de 18 ans et plus.

Mes prompts sont-ils utilisés pour entraîner un modèle ?

Non. Les prompts ne sont pas utilisés pour l'entraînement.

En quoi cela diffère-t-il d'un passage par un agrégateur ?

Un agrégateur vous redirige vers plusieurs modèles, chacun avec ses propres règles. Ce service propose un seul modèle derrière une seule politique. Le guide Uncensored OpenRouter: A Practical Guide to détaille cette comparaison en profondeur.

Peut-il voir des images ou créer des embeddings ?

Non. Il ne gère que du texte, sans embeddings, images, audio, vidéo ni ajustement fin (fine-tuning).

Dépannage

J'obtiens un 402 avec no_credit. Que faire maintenant ?

Votre solde est épuisé ou l'essai a expiré. Rechargez le solde prépayé et renvoyez la requête.

Une requête retourne 503 upstream_busy.

C'est temporaire. Attendez quelques secondes et réessayez, en utilisant un délai croissant et une part d'aléatoire si vous exécutez plusieurs workers.

Mon flux se termine et je ne trouve pas le nombre de tokens.

Avec le streaming activé, un dernier chunk contenant usage est ajouté automatiquement, juste avant data: [DONE]. Sa liste choices est vide, vérifiez donc cela avant d'indexer.

Les outils et l'appel de fonctions fonctionnent-ils ?

Oui, au format standard : passez un tableau tools et recherchez tool_calls dans la réponse.