Introduzione rapida API Wu Shencha
Accedi rapidamente a un LLM senza censura tramite API Wu Shencha con l'interfaccia compatibile OpenAI. Questa guida mostra configurazione, esempi e limiti per iniziare a costo zero.
Configurazione di base
Wu Shencha API offre un'interfaccia standard compatibile con OpenAI. Devi impostare l'URL di base e la chiave API nel codice. L'URL di base è fisso a https://api.wushenchaapi.com/v1. L'ID del modello è uncensored, un modello a pesi aperti ottimizzato per scenari senza censura, che supporta contenuti per adulti legali.
La chiave appare nella pagina "Ottieni chiave API" dopo la registrazione. Essendo compatibile con OpenAI, puoi collegarti modificando semplicemente il parametro base_url nell'SDK ufficiale. Nessuna configurazione di routing o impostazioni complesse necessarie.
Endpoint chat completamento
Invia richieste di testo all'endpoint POST /v1/chat/completions. L'endpoint accetta il formato di messaggio standard e restituisce il testo generato. È il metodo di interazione di base, adatto alla maggior parte dei casi di generazione di testo.
Il corpo della richiesta deve includere i campi model e messages. Assicurati che la dimensione della richiesta non superi gli 8 MB. Se la chiave non è valida o il credito è insufficiente, l'API restituisce codici di errore.
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
Per gli sviluppatori Python, puoi usare l'SDK ufficiale openai. Basta puntare base_url all'endpoint di Wu Shencha e passare la tua chiave API. Questo mantiene la coerenza con il codice nativo OpenAI, facilitando la migrazione.
Assicurati di installare l'ultima versione dell'SDK. L'esempio di codice mostra come inizializzare il client e inviare messaggi. Questo approccio è conciso ed efficiente, ideale per lo sviluppo di prototipi rapidi.
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
Gli sviluppatori Node.js possono connettersi utilizzando il pacchetto npm openai. La configurazione è simile a quella di Python: imposta baseURL e apiKey. Questo garantisce la coerenza tra i linguaggi e riduce i costi di apprendimento.
Supporta richieste parallele e gestione degli errori. Puoi integrarlo facilmente nelle tue applicazioni Node.js esistenti. Gestisci le callback asincrone o le Promise per evitare blocchi.
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
Supporta lo streaming tramite Server-Sent Events (SSE). Imposta il parametro stream: true e l'API restituirà i dati di risposta a blocchi. Utile per applicazioni in tempo reale o generazione di testo lungo, offre un'esperienza a latenza ridotta.
La risposta in streaming non modifica il comportamento del modello, cambia solo il modo di trasmissione dei dati. Puoi scegliere lo streaming o la modalità non streaming su richiesta.
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)
Limiti e quote
Massimo 300 richieste al minuto. Finestra di contesto di 100.000 token (inclusi prompt e completamento). Se superi il limite, l'API restituisce un errore 429. Chiave non valida restituisce 401, saldo insufficiente restituisce 402.
Il credito prepagato non scade mai, nessun canone mensile. Limite dimensione richiesta per ogni chiamata: 8 MB. Questi limiti garantiscono la stabilità del servizio. Puoi generare una nuova chiave in qualsiasi momento per revocare quella vecchia.
Scheda tecnica dell'API
Tutti i limiti e le funzioni reali dell'API in un unico posto: controllali prima di ricaricare.
| Voce | Valore |
|---|---|
| Formato | compatibile OpenAI: qualsiasi SDK OpenAI funziona cambiando base URL e chiave |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID modello | uncensored |
| Base URL | https://api.wushenchaapi.com/v1 |
| Modalità JSON | response_format: {"type": "json_object"} |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Output massimo | fino a 16.000 token per richiesta (predefinito 2.048) |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Finestra di contesto | 100.000 token (input + output) |
| Concorrenza | 8 richieste contemporanee per chiave |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Dimensione | fino a 8 MB per richiesta |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $10 a $500 |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Prova gratuita | $0,50 per 7 giorni, senza carta |
| Prezzo | $0,25 per 1M token in input · $1,00 per 1M in output |
| Bonus | +5% da $50, +10% da $100 |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| Accesso | Google oppure e-mail e password |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
Codici di errore
Gli errori arrivano in JSON con un type fisso; le richieste fallite o rifiutate non si pagano.
| Codice | Tipo | Significato |
|---|---|---|
400 | bad_request | JSON non valido, messaggi vuoti, parametro errato o contesto troppo lungo |
401 | missing_key · invalid_key · key_revoked | chiave mancante, errata o sostituita |
402 | no_credit | credito esaurito — ricarica e riparti subito |
403 | content_blocked | contenuti sessuali con minori — rifiutato, non addebitato |
404 | not_found | endpoint sconosciuto |
413 | request_too_large | corpo oltre 8 MB |
429 | rate_limited · concurrency | oltre 300/min o 8 in parallelo — attendi e riprova |
503 | upstream_busy | modello occupato — riprova tra pochi secondi |
Domande frequenti
L'API Wu Shencha supporta embedding o generazione di immagini?
Attualmente supporta solo l'endpoint chat completamento. Non supporta embedding, immagini, audio o video. Focalizzato sull'interazione testuale pura per garantire alte prestazioni e bassa latenza.
Come ottenere la chiave API?
Dopo la registrazione, visualizza la chiave API nella pagina "Ottieni chiave API". I nuovi account ricevono $0,50 di credito di prova gratuito senza carta di credito. La chiave può essere rigenerata in qualsiasi momento e quella vecchia diventerà immediatamente non valida.
Come vengono calcolati i prezzi?
$0,25 per milione di token di input, $1,00 per milione di token di output. Pagamento a consumo, nessun canone. Ricarica minima $10, sconto del 5% sopra $50 e del 10% sopra $100. Il credito non scade mai.
Compila il modulo per ottenere la chiave
Crea un account, copia la chiave, modifica l'URL di base. La configurazione è così semplice.