Guida rapida a Wu Xianzhi API

Endpoint di base e autenticazione API

Wu Xianzhi API è pienamente compatibile con l'interfaccia standard OpenAI. Invia tutte le richieste a https://api.wuxianzhiapi.com/v1. Serve una chiave API per l'autenticazione, inserita nell'intestazione Authorization: Bearer YOUR_API_KEY. La chiave viene generata subito dopo la registrazione e può essere rigenerata per invalidare quella vecchia. Utilizziamo il credito prepagato: il saldo non scade mai, paghi a consumo e non ci sono abbonamenti.

Invia la prima richiesta

Usa curl per verificare la connettività API. Invia una richiesta POST a /v1/chat/completions specificando l'ID del modello uncensored. Questo modello open-weight indipendente è ottimizzato per i contenuti adulti legali e i temi controversi, senza rifiuto di generazione.

Assicurati che il corpo della richiesta contenga l'array messages. Il codice 401 indica autenticazione fallita, il 402 indica saldo insufficiente.

复制curl https://api.wuxianzhiapi.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."}]
  }'

Esempio di chiamata SDK Python

Per gli sviluppatori Python, usa direttamente la libreria ufficiale openai. Modifica solo base_url per puntare al nostro server e inserisci la chiave API corretta. L'ID del modello è fisso a uncensored. Supportiamo solo la generazione di testo, senza embedding o multimodalità. Ideale per l'integrazione backend e il trattamento di dati strutturati.

复制from openai import OpenAI

client = OpenAI(base_url="https://api.wuxianzhiapi.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)

Integrazione SDK Node.js

Gli sviluppatori Node.js possono usare il pacchetto npm openai. Configura baseURL e apiKey; la logica di chiamata è identica a OpenAI. Questa API LLM senza censura supporta la chiamata di funzioni: definisci le funzioni con tools e ricevi JSON strutturato da eseguire. Ideale come backend per app AI senza limiti.

复制import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.wuxianzhiapi.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);

Risposte in streaming (SSE)

Per ridurre la latenza del primo token, si consiglia di impostare stream: true nella richiesta. L'API restituirà risposte chunked tramite Server-Sent Events (SSE). Questo è fondamentale per scenari di conversazione in tempo reale o generazione di testo lungo. Il client deve ascoltare l'evento data e analizzare i chunk JSON per assemblare il contenuto finale. Lo streaming non modifica il metodo di fatturazione, che rimane basato sul numero totale di token di input e output.

复制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, gestione errori e finestra di contesto

Ogni chiave API è limitata a 300 richieste/minuto e il corpo della richiesta non deve superare 8 MB. La finestra di contesto è di 100.000 token (prompt + risposta). Errori: 401 (chiave non valida), 402 (saldo insufficiente), 429 (limite di richieste raggiunto). Il modello blocca rigidamente i contenuti sessuali minori, ma non censura altri contenuti adulti legali. Ottieni l'elenco dei modelli con GET /v1/models.