FAQ API senza censura: registrazione, fatturazione, endpoint, codici di errore e limiti di contenuto

Registrazione e prova gratuita

Come si registra. È necessario collegare una carta di pagamento?

Registrati alla pagina /get-api-key/ con email e password, senza carta di credito. Dopo la registrazione la chiave viene visualizzata immediatamente, senza attesa di approvazione.

Quanto credito di prova ha il nuovo account e per quanto tempo?

I nuovi account ricevono un credito di prova gratuito di $0,50 valido per 7 giorni. Al costo di $1,00 per milione di token, il credito è sufficiente per generare circa 500.000 token di risposta, il che è adeguato per i test di integrazione e le verifiche su piccola scala.

Quante chiavi può avere un account? Cosa fare se si perde?

Ogni account dispone di un'unica chiave API. Se viene persa o compromessa, puoi rigenerarla dalle impostazioni dell'account: la chiave precedente diventerà immediatamente inattiva e tutti i servizi che la usano ancora riceveranno un errore 401. Ricorda di aggiornare le variabili d'ambiente dopo il cambio.

Cosa succede alla scadenza del credito di prova?

Scaduta la prova, le richieste restituiscono 402 con errore no_credit. Per continuare è necessario ricaricare il saldo prepagato del tuo account; il codice non cambia.

Fatturazione e saldo

Qual è il prezzo e come si fattura?

Fatturazione a token: input $0,25 / milione di token, output $1,00 / milione di token. Nessun abbonamento, nessun canone mensile, paghi solo quello che usi. Vedi pagina prezzi per i dettagli.

Il saldo scade?

No. Il saldo prepagato ricaricato non ha scadenza, solo il credito di prova iniziale di $0,50 ha un limite di 7 giorni.

Come sapere quanto costa una richiesta?

Il campo usage nella risposta indica i token di input e output usati; moltiplicandoli per il prezzo unitario ottieni il costo. Anche l'ultimo chunk dello streaming contiene usage; nota che in quel blocco choices è un array vuoto.

Come evitare costi elevati imprevisti?

Usa max_tokens per limitare l'output (default 2048) e taglia la cronologia nelle conversazioni a più turni. Essendo prepagato, il saldo esaurito blocca le richieste senza generare bollette oltre il saldo.

Quanto costa una richiesta normale?

Esempio: input 2.000 token, output 500 token. Input ~$0,0005, output ~$0,0005, totale ~$0,001. Circa 1.000 richieste costano $1. I valori reali dipendono dal campo usage nella risposta.

Cosa succede quando il saldo è esaurito?

L'endpoint restituisce 402 con codice no_credit. Dopo la ricarica puoi continuare a usare l'API senza rigenerare la chiave.

Endpoint e parametri

Qual è l'indirizzo dell'endpoint e il nome del modello?

Base URL: https://api.wuxianzhiapi.com/v1. Il modello è sempre uncensored. Gli endpoint disponibili sono POST /v1/chat/completions e GET /v1/models.

È compatibile con gli SDK OpenAI?

Sì. Le librerie ufficiali Python openai v1+ e npm openai v4+ funzionano cambiando solo base_url e la chiave. Vedi esempi di codice per i dettagli o guida alla migrazione.

Quanto è lungo il contesto? Quanto può essere max_tokens?

Il contesto è di 100.000 token, la somma di prompt e output non può superarlo. max_tokens è 2048 di default, massimo 32.000. Il corpo della richiesta non deve superare 8 MB.

Supporta lo streaming e la chiamata di funzioni?

Sì. Usa stream: true; il server aggiunge un ultimo chunk con usage. Per la chiamata di funzioni usa tools e tool_choice in formato OpenAI; i risultati degli strumenti tornano come messaggio con role: "tool".

Perché l'ultimo blocco della risposta in streaming non contiene testo?

Si tratta di un blocco di statistiche di utilizzo aggiunto automaticamente: l'array choices è vuoto e usage contiene il numero di token di questa richiesta. Verifica se choices è vuoto prima di estrarre il contenuto per evitare errori di indice fuori limite.

Sono presenti limiti di velocità?

Ogni chiave API è soggetta a 300 richieste al minuto. Superato il limite, viene restituito l'errore 429: attendi e riprova, si consiglia l'uso della backoff esponenziale.

Supporta embedding, immagini, audio o fine-tuning?

Nessuna di queste funzionalità. Offriamo solo il dialogo testuale con un unico modello uncensored, senza embedding, generazione di immagini, audio, video o fine-tuning.

Codici di errore

Tutte le risposte di errore sono in formato JSON, con la struttura {"error":{"code":...,"message":...}}. Di seguito viene spiegato come gestire ogni risposta in base allo stato.

Cosa indica l'errore 400?

La richiesta presenta un problema: il più comune è che la somma del prompt e di max_tokens superi i 100.000 token, oppure che il formato JSON o i tipi di campo non siano corretti. Devi modificare la richiesta; riprovare non servirà a nulla.

Come risolvere l'errore 401?

Chiave API non valida o mancante. Verifica che l'intestazione della richiesta sia Authorization: Bearer <chiave_api>, che le variabili d'ambiente siano attive e che la chiave non sia stata rigenerata: una chiave rigenerata diventa immediatamente invalida.

Cosa significa 402 no_credit?

Il saldo è esaurito o il credito di prova gratuito è scaduto. Ricarica l'account per ripristinare il servizio, senza bisogno di cambiare la chiave API.

Cosa significa 403 content_blocked?

La richiesta ha attivato il blocco dei contenuti. I contenuti sessualmente espliciti che coinvolgono minori vengono sempre bloccati, anche nei contesti di finzione e di roleplay; questo limite non è modificabile. Modifica il testo della richiesta e riprova: se invii la stessa richiesta, il risultato non cambierà.

Cosa indica l'errore 404?

Hai tentato di accedere a un endpoint inesistente. Le cause più comuni sono un URL errato (ad esempio la mancanza di /v1) o il tentativo di utilizzare endpoint non supportati, come gli embedding o la generazione di immagini.

Come gestire gli errori 429 e 503?

429 indica che è stato superato il limite di richieste di 300 al minuto; 503 restituisce il codice di errore upstream_busy, che segnala che il modello è temporaneamente occupato. Riprova tra qualche secondo. In entrambi i casi è consigliabile utilizzare la backoff esponenziale; un esempio è disponibile nella pagina degli esempi di codice.

Confini dei contenuti

Il modello senza censura genera qualsiasi contenuto?

No. I contenuti per adulti legali, le opere di finzione e gli argomenti controversi non vengono rifiutati, ma i contenuti sessuali che coinvolgono minori vengono sempre bloccati con un errore 403, sia che si tratti di finzione o di giochi di ruolo. L'utilizzo deve essere conforme alla legge.

A chi è destinato il servizio?

Esclusivamente agli utenti adulti di età superiore ai 18 anni. Se utilizzi il servizio per creare prodotti destinati agli utenti finali, devi implementare una verifica dell'età nella tua applicazione e mantenere meccanismi di segnalazione e gestione degli account.

Può essere utilizzato per giochi di ruolo, narrativa e videogiochi?

Sì, è l'utilizzo più tipico. Puoi trovare esempi di prompt e stime dei costi per vari scenari nell'articolo Casi d'uso.

Quando il modello restituisce un errore 403 durante un gioco di ruolo?

Solo quando viene attivato il blocco dei contenuti, tipicamente per contenuti sessuali che coinvolgono minori, anche nelle impostazioni di finzione. I contenuti legali tra adulti non vengono rifiutati solo perché si tratta di un gioco di ruolo. In caso di errore 403, modifica il personaggio o la trama e riprova.

Le informazioni fornite dal modello sono sempre affidabili?

Non necessariamente. Il fatto che il modello non rifiuti una risposta non garantisce la sua accuratezza. Per conclusioni basate su fatti, dati, diritto o medicina, è tua responsabilità verificare le informazioni prima di utilizzarle.

Privacy

I miei prompt verranno utilizzati per addestrare il modello?

No. I prompt che invii non verranno utilizzati per l'addestramento.

Come devo proteggere la chiave API?

Conserva la chiave API nelle variabili d'ambiente del server; non inserirla nelle pagine frontend, negli installer per dispositivi mobili o nei repository di codice pubblici. Se sospetti una fuoriuscita, rigerala immediatamente dall'account: la chiave precedente diventerà immediatamente invalida.

Come devo gestire i dati degli utenti nelle mie applicazioni?

Questa scelta dipende dal tuo prodotto. Si consiglia di inviare solo i dati strettamente necessari al completamento del compito ed evitare di inserire informazioni sensibili come nomi reali, numeri di documento o contatti nei prompt. Specifica chiaramente nel tuo Informativa sulla privacy come vengono trattati i dati.