FAQ API sans censure : inscription, facturation, endpoint, codes d'erreur et limites de contenu

Inscription et essai gratuit

Comment s'inscrire, faut-il lier une carte bancaire ?

Inscrivez-vous sur la page /get-api-key/ avec e-mail et mot de passe, sans carte bancaire. La clé s'affiche immédiatement après la réussite de l'inscription, sans attente de validation.

Quel est le montant du crédit d'essai pour un nouveau compte et pour combien de temps ?

Un nouveau compte reçoit $0,50 de crédit d'essai, valable 7 jours. À $1,00 / million de tokens en sortie, cela génère environ 500 000 tokens de réponse, suffisant pour les tests d'intégration et les validations à petite échelle.

Combien de clés par compte ? Que faire en cas de perte ?

Un seul clé par compte. En cas de fuite ou de perte, régénérez-la dans votre compte : l'ancienne devient immédiatement invalide et renvoie 401. Pensez à mettre à jour les variables d'environnement sur tous les services concernés.

Que se passe-t-il à l'expiration de l'essai ?

Après expiration, les requêtes renverront 402 avec le code d'erreur no_credit. Rechargez votre solde prépayé pour continuer, sans modifier votre code.

Facturation et solde

Quel est le prix et comment est facturée l'utilisation ?

Facturation au token : entrée $0,25 / million de tokens, sortie $1,00 / million de tokens. Pas d'abonnement, pas de frais mensuels, vous payez ce que vous consommez. Voir la page Prix pour les détails.

Le solde expire-t-il ?

Non. Le solde prépayé rechargé n'a pas de date d'expiration. Seuls les $0,50 de crédit d'essai du nouveau compte sont limités à 7 jours.

Comment savoir combien coûte une requête ?

Le champ usage de chaque réponse indique le nombre de tokens d'entrée et de sortie ; multipliez par le prix unitaire pour obtenir le coût. Les requêtes en streaming incluent aussi usage dans le dernier bloc de données ; notez que ce bloc a un choices vide.

Comment éviter des frais élevés imprévus ?

Deux méthodes : limitez la sortie avec max_tokens (par défaut 2048) et coupez l'historique dans les conversations multi-tours pour éviter que l'entrée n'augmente indéfiniment. Comme c'est du prépayé, les requêtes s'arrêtent dès que le solde est épuisé, sans frais supplémentaires.

Combien coûte une requête standard en exemple ?

Exemple : 2 000 tokens d'entrée et 500 tokens de sortie. Coût d'entrée ≈ $0,0005, coût de sortie ≈ $0,0005, total ≈ $0,001. Soit environ $1 pour mille requêtes de ce type. La valeur exacte dépend du champ usage dans la réponse.

Que se passe-t-il lorsque le solde est épuisé ?

L'endpoint renvoie 402 avec le code d'erreur no_credit. Après avoir rechargé votre solde, vous pouvez continuer à utiliser l'API sans régénérer votre clé API.

Endpoint et paramètres

Quelle est l'URL de l'endpoint et le nom du modèle ?

L'URL de base est https://api.wuxianzhiapi.com/v1 et le nom du modèle est toujours uncensored. Les endpoints disponibles sont POST /v1/chat/completions et GET /v1/models.

Est-ce compatible avec les SDK OpenAI ?

Compatible. La bibliothèque officielle Python openai v1+ et le package npm openai v4+ fonctionnent dès que vous modifiez l'URL de base et la clé API. Consultez les exemples de code et le guide de migration pour les autres endpoints.

Quelle est la taille de la fenêtre de contexte ? Quelle valeur pour max_tokens ?

La fenêtre de contexte est de 100 000 tokens ; la somme du prompt et de la sortie ne doit pas dépasser ce nombre. max_tokens vaut 2048 par défaut, avec un maximum de 32 000 par requête. Le corps de la requête ne doit pas dépasser 8 Mo.

Le streaming et l'appel de fonctions sont-ils supportés ?

Les deux sont pris en charge. Pour le streaming, utilisez stream: true ; le serveur ajoutera automatiquement un dernier bloc de données contenant usage à la fin. Pour l'appel de fonctions, utilisez les champs tools et tool_choice au format OpenAI ; les résultats des outils sont renvoyés avec le message role: "tool".

Pourquoi le dernier morceau de la réponse en streaming ne contient-il pas de texte ?

Il s'agit du bloc de statistiques d'utilisation ajouté automatiquement ; le tableau choices est vide et usage contient le nombre de tokens de cette requête. Pour éviter les erreurs d'indice hors limites, vérifiez si choices est vide avant de récupérer le contenu.

Y a-t-il une limite de débit ?

Chaque clé API est limitée à 300 requêtes par minute. Si cette limite est dépassée, le serveur renvoie un code 429 ; il suffit d'attendre puis de réessayer. Il est recommandé d'utiliser une stratégie de backoff exponentiel.

Prenez-vous en charge les vecteurs, les images, l'audio ou le fine-tuning ?

Ils ne sont pas pris en charge. Nous proposons uniquement la conversation textuelle avec le modèle uncensored. Nous ne proposons pas d'embeddings, ni de génération d'images, d'audio, de vidéo ou de fine-tuning.

Codes d'erreur

Toutes les réponses d'erreur sont au format JSON, avec la structure suivante : {"error":{"code":...,"message":...}}. Voici comment traiter chaque erreur selon son code de statut.

Que signifie l'erreur 400 ?

La requête elle-même est incorrecte. La cause la plus fréquente est que la somme du prompt et de max_tokens dépasse 100 000 tokens, ou que le format JSON ou les types de champs sont erronés. Vous devez corriger la requête ; un simple réessai ne suffira pas.

Comment diagnostiquer une erreur 401 ?

Clé invalide ou non transmise. Vérifiez l'en-tête de la requête Authorization: Bearer <clé>, que la variable d'environnement est active, et si la clé a été régénérée : une clé régénérée invalide immédiatement l'ancienne.

Que signifie l'erreur 402 no_credit ?

Le solde est épuisé ou le crédit d'essai gratuit a expiré. Rechargez votre compte pour rétablir l'accès ; aucun changement de clé API n'est nécessaire.

Que signifie l'erreur 403 content_blocked ?

La requête a déclenché un blocage de contenu. Le contenu sexuel impliquant des mineurs est toujours bloqué, qu'il s'agisse de contenu fictif ou de jeu de rôle. Ce paramètre est inmodifiable. Modifiez le contenu de votre requête et réessayez ; renvoyer la même requête donnera le même résultat.

Que signifie l'erreur 404 ?

Endpoint inexistant. Cause fréquente : URL erronée, ex. /v1 manquant, ou appel d'un endpoint non supporté comme embeddings ou génération d'images.

Comment traiter les erreurs 429 et 503 ?

Le code 429 indique que vous avez dépassé la limite de débit de 300 requêtes par minute. Le code 503 est associé au message d'erreur upstream_busy, indiquant que le modèle est temporairement occupé ; réessayez dans quelques secondes. Pour les deux cas, une stratégie de backoff exponentiel est recommandée (voir la page des exemples de code).

Limites de contenu

Le modèle « sans censure » peut-il tout générer ?

Non. Le contenu adulte légal, la fiction et les sujets controversés ne sont pas bloqués, mais le contenu sexuel impliquant des mineurs est toujours bloqué (code 403), qu'il soit fictif ou issu d'un jeu de rôle. L'utilisation doit être légale.

À qui s'adresse ce service ?

Uniquement aux utilisateurs majeurs (18 ans et plus). Si vous l'intégrez dans un produit destiné aux utilisateurs finaux, vous devez mettre en place une vérification de l'âge dans votre application et conserver des mécanismes de signalement et de gestion des comptes.

Peut-on l'utiliser pour le jeu de rôle, les romans ou les jeux ?

Oui, c'est l'utilisation la plus courante. Consultez l'article Scénarios d'application pour des exemples de prompts et des estimations de coûts par scénario.

Dans quels cas le modèle renvoie-t-il une erreur 403 lors d'un jeu de rôle ?

Un code 403 est renvoyé uniquement lorsqu'un blocage de contenu est déclenché, typiquement pour du contenu sexuel impliquant des mineurs, y compris dans les univers fictifs. Le contenu adulte légal entre deux majeurs n'est pas bloqué simplement parce qu'il s'agit d'un jeu de rôle. En cas de code 403, ajustez le personnage ou l'intrigue avant de soumettre une nouvelle requête.

Les faits rapportés par le modèle sont-ils toujours fiables ?

Pas nécessairement. Le fait qu'une réponse ne soit pas bloquée ne garantit pas son exactitude. Pour les affirmations factuelles, les données, les conclusions juridiques ou médicales, vous devez vérifier vous-même leur exactitude avant de les utiliser.

Confidentialité

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

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

Comment conserver ma clé API en toute sécurité ?

Conservez la clé API dans les variables d'environnement de votre serveur. Ne l'inscrivez pas dans le code frontend, les paquets d'application mobile ou les dépôts publics. En cas de doute sur une fuite, régénérez immédiatement une nouvelle clé depuis votre compte ; l'ancienne deviendra invalide instantanément.

Comment traiter les données des utilisateurs dans mon application ?

Cela dépend de votre propre produit. Il est recommandé de n'envoyer que les données strictement nécessaires à la tâche. Évitez d'inclure des informations sensibles telles que les noms réels, les numéros de pièce d'identité ou les coordonnées dans vos prompts. Précisez clairement dans votre politique de confidentialité comment vos données sont traitées.