Guide de démarrage API Wu Shencha
Accédez rapidement aux grands modèles sans censure via l'API Wu Shencha et commencez avec une interface compatible OpenAI. Cette documentation fournit la configuration de base, des exemples de requêtes et les limites, pour vous permettre de démarrer à coût nul.
Configuration de base
L'API Wu Shencha fournit une interface compatible OpenAI standard. Vous devez définir l'URL de base et la clé API dans votre code. L'URL de base est fixe : https://api.wushenchaapi.com/v1. L'ID du modèle est uncensored, il s'agit d'un modèle à poids ouverts ajusté, conçu pour des scénarios sans censure et prenant en charge le contenu adulte conforme à la loi.
La clé s'affiche sur la page « Obtenir la clé API » après l'inscription. L'API étant compatible OpenAI, vous pouvez vous intégrer directement en modifiant le paramètre base_url du SDK officiel. Aucune configuration de routage ni configuration complexe n'est nécessaire.
Interface de complétion de chat
Utilisez l'endpoint POST /v1/chat/completions pour envoyer des requêtes textuelles. L'interface accepte le format de messages standard et renvoie le texte généré. C'est l'interaction de base, adaptée à la plupart des scénarios de génération de texte.
Le corps de la requête doit inclure les champs model et messages. Assurez-vous que la taille de votre requête ne dépasse pas 8 MB. L'API renvoie un code d'erreur si la clé est invalide ou si le solde est insuffisant.
curl https://api.wushenchaapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
SDK Python
Les développeurs Python peuvent utiliser le SDK officiel openai. Pointez simplement le paramètre base_url vers l'endpoint de l'API Wu Shencha et fournissez votre clé API. Cette méthode préserve la compatibilité avec le code natif OpenAI, facilitant la migration.
Assurez-vous d'installer la dernière version du SDK. L'exemple de code montre comment initialiser le client et envoyer des messages. Cette approche est concise et efficace, idéale pour le prototypage rapide.
from openai import OpenAI
client = OpenAI(base_url="https://api.wushenchaapi.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)
SDK Node.js
Les développeurs Node.js peuvent également utiliser le package npm openai pour se connecter. La configuration est similaire à celle de Python : définissez baseURL et apiKey. Cela assure la cohérence multi-langages et réduit la courbe d'apprentissage.
Prend en charge les requêtes asynchrones et la gestion des erreurs. Vous pouvez l'intégrer facilement dans vos applications Node.js existantes. Veillez à gérer les rappels asynchrones ou les Promises pour éviter les blocages.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.wushenchaapi.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
Le streaming est assuré via les Server-Sent Events (SSE). Définissez le paramètre stream: true et l'API renverra les données de réponse par blocs. Cela est très utile pour les applications en temps réel ou la génération de longs textes, offrant une expérience à faible latence.
Le streaming ne modifie pas le comportement du modèle, il change uniquement le mode de transfert des données. Vous pouvez choisir le mode streaming ou non streaming selon vos besoins.
stream = 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)
Limites et quotas
Maximum 300 requêtes par minute. La fenêtre de contexte est de 100 000 tokens (incluant le prompt et la complétion). L'API renvoie une erreur 429 si les limites sont dépassées, une erreur 401 pour une clé invalide et une erreur 402 pour un solde insuffisant.
Le crédit prépayé n'expire jamais, sans frais mensuels. La taille maximale de chaque requête est de 8 MB. Ces limites garantissent la stabilité du service. Vous pouvez générer une nouvelle clé à tout moment pour révoquer l'ancienne.
Fonctions et limites
Toutes les limites et fonctions réelles de l'API au même endroit — vérifiez-les avant de recharger.
| Élément | Valeur |
|---|---|
| Format | compatible OpenAI : tout SDK OpenAI fonctionne en changeant la base URL et la clé |
| Authentification | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| ID du modèle | uncensored |
| Base URL | https://api.wushenchaapi.com/v1 |
| Mode JSON | response_format: {"type": "json_object"} |
| Paramètres | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Sortie max. | jusqu'à 16 000 tokens par requête (2 048 par défaut) |
| Appel de fonctions | oui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool |
| Streaming | oui — server-sent events ; le dernier bloc contient l'usage des tokens |
| Fenêtre de contexte | 100 000 tokens (entrée + sortie) |
| Concurrence | 8 requêtes simultanées par clé |
| Limite de débit | 300 requêtes par minute et par clé |
| En-têtes | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Taille | jusqu'à 8 Mo par requête |
| Recharge | USDT (TRC20) ou USDC (Base), tout montant entier de 10 $ à 500 $ |
| Validité | le crédit payé n'expire jamais, sans abonnement |
| Essai gratuit | 0,50 $ pendant 7 jours, sans carte |
| Prix | 0,25 $ par million de tokens en entrée · 1,00 $ par million en sortie |
| Bonus | +5 % dès 50 $, +10 % dès 100 $ |
| Facturation | crédit prépayé selon l'usage réel ; erreurs et refus gratuits |
| Connexion | Google ou e-mail et mot de passe |
| Contenu | contenu adulte autorisé ; tout contenu sexuel impliquant des mineurs est refusé |
| Clés | une clé active par compte ; une nouvelle remplace l'ancienne |
Erreurs et solutions
Les erreurs arrivent en JSON avec un type stable ; les requêtes échouées ou refusées ne sont pas facturées.
| Code | Type | Signification |
|---|---|---|
400 | bad_request | JSON invalide, messages vides, mauvais paramètre ou contexte trop long |
401 | missing_key · invalid_key · key_revoked | clé absente, erronée ou remplacée |
402 | no_credit | plus de crédit — rechargez, la reprise est immédiate |
403 | content_blocked | contenu sexuel impliquant des mineurs — refusé, non facturé |
404 | not_found | endpoint inconnu |
413 | request_too_large | corps supérieur à 8 Mo |
429 | rate_limited · concurrency | au-delà de 300/min ou 8 en parallèle — patientez |
503 | upstream_busy | modèle occupé — réessayez dans quelques secondes |
Questions fréquentes
L'API Wu Shencha supporte-t-elle l'embedding ou la génération d'images ?
Actuellement, seul l'endpoint de complétion de chat est pris en charge. Les embeddings, la génération d'images, d'audio ou de vidéo ne sont pas supportés. La focalisation sur les interactions en texte pur garantit des performances élevées et une faible latence.
Comment obtenir une clé API ?
Consultez la page « Obtenir une clé API » après l'inscription. Les nouveaux comptes reçoivent $0,50 de crédit d'essai gratuit, sans carte bancaire. La clé peut être régénérée à tout moment ; l'ancienne devient immédiatement invalide.
Comment les prix sont-ils calculés ?
$0,25 par million de tokens d'entrée, $1,00 par million de tokens de sortie. Paiement à l'usage, sans frais mensuels. Rechargez à partir de $10, obtenez 5 % de bonus pour $50 et 10 % pour $100. Le crédit prépayé n'expire jamais.
Remplissez simplement le formulaire pour obtenir une clé
Créez un compte, copiez la clé et modifiez l'URL de base. La configuration est aussi simple que ça.