FR ▾
Obtenir une clé API

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émentValeur
Formatcompatible OpenAI : tout SDK OpenAI fonctionne en changeant la base URL et la clé
AuthentificationAuthorization: Bearer YOUR_KEY
EndpointsPOST /v1/chat/completions · GET /v1/models
ID du modèleuncensored
Base URLhttps://api.wushenchaapi.com/v1
Mode JSONresponse_format: {"type": "json_object"}
Paramètrestemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Sortie max.jusqu'à 16 000 tokens par requête (2 048 par défaut)
Appel de fonctionsoui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool
Streamingoui — server-sent events ; le dernier bloc contient l'usage des tokens
Fenêtre de contexte100 000 tokens (entrée + sortie)
Concurrence8 requêtes simultanées par clé
Limite de débit300 requêtes par minute et par clé
En-têtesX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Taillejusqu'à 8 Mo par requête
RechargeUSDT (TRC20) ou USDC (Base), tout montant entier de 10 $ à 500 $
Validitéle crédit payé n'expire jamais, sans abonnement
Essai gratuit0,50 $ pendant 7 jours, sans carte
Prix0,25 $ par million de tokens en entrée · 1,00 $ par million en sortie
Bonus+5 % dès 50 $, +10 % dès 100 $
Facturationcrédit prépayé selon l'usage réel ; erreurs et refus gratuits
ConnexionGoogle ou e-mail et mot de passe
Contenucontenu adulte autorisé ; tout contenu sexuel impliquant des mineurs est refusé
Clésune 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.

CodeTypeSignification
400bad_requestJSON invalide, messages vides, mauvais paramètre ou contexte trop long
401missing_key · invalid_key · key_revokedclé absente, erronée ou remplacée
402no_creditplus de crédit — rechargez, la reprise est immédiate
403content_blockedcontenu sexuel impliquant des mineurs — refusé, non facturé
404not_foundendpoint inconnu
413request_too_largecorps supérieur à 8 Mo
429rate_limited · concurrencyau-delà de 300/min ou 8 en parallèle — patientez
503upstream_busymodè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.