Guida rapida all'API senza censura

Installazione e librerie necessarie

L'API senza censura è progettata per funzionare direttamente con gli SDK e i client OpenAI. Per l'installazione dell'integrazione, devi solo impostare il valore di base_url nel tuo codice esistente su https://api.sansursuzapi.com/v1 e configurare la tua chiave API. È sufficiente installare il pacchetto SDK appropriato per il linguaggio che utilizzi; non è necessaria alcuna configurazione aggiuntiva del server o meccanismi di autenticazione complessi. Il nostro sistema utilizza l'autenticazione standard tramite token Bearer e trasmettiamo la tua chiave direttamente nelle intestazioni delle richieste.

Esempio di richiesta di base

Puoi attivare la generazione di testo inviando una semplice richiesta POST per iniziare a utilizzare l'API. L'esempio seguente mostra come accedere al modello uncensored tramite curl. Il corpo della richiesta specifica il nome del modello, il messaggio dell'utente e il formato di risposta. Questa struttura segue lo schema standard chat-completions di OpenAI.

Kopyalacurl https://api.sansursuzapi.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."}]
  }'

Questa richiesta è un punto di partenza ideale per testare il comportamento senza censura del modello. L'oggetto JSON restituito come risposta contiene il testo generato e le statistiche sui token. Puoi utilizzare questa struttura semplice per test rapidi e poi personalizzare i parametri in base alle esigenze del tuo progetto.

Streaming e chiamata di funzioni

Per blocchi di testo grandi o scenari con lunghe cronologie di conversazione, puoi utilizzare la modalità streaming. Questa modalità ti consente di elaborare i dati ricevuti dal server in parti, migliorando l'esperienza utente. È inoltre supportata la funzionalità di chiamata di funzioni (function calling), che permette al modello di interagire con strumenti esterni. Questa funzionalità consente al modello di restituire dati secondo uno schema JSON specifico e di elaborarli nella tua applicazione.

Kopyalafrom openai import OpenAI

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

Kopyalaimport OpenAI from "openai";

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

Gli SDK Python e Node.js forniscono gli strumenti necessari per gestire queste strutture di streaming e chiamate di funzioni. Facoltativamente, puoi ricevere la risposta in parti con il parametro stream: true o configurare la generazione di dati del modello utilizzando la struttura tools.

Elenco modelli e compatibilità

La nostra API offre attualmente un unico grande modello linguistico: uncensored. Questo modello ha una struttura a pesi aperti ottimizzata per rimuovere i filtri artificiali presenti nei modelli standard. Puoi verificare il modello disponibile tramite l'endpoint dell'elenco dei modelli (GET /v1/models). Il modello funziona sui nostri server GPU in modo indipendente dalle serie GPT, Claude, Gemini o Grok di OpenAI. Questa compatibilità ti consente di utilizzare direttamente i tuoi client OpenAI esistenti.

Codici di errore e limiti

I principali codici di stato che potresti incontrare durante l'utilizzo dell'API sono: 401 chiave API non valida o mancante, 402 credito insufficiente e 429 superamento del limite di 300 richieste al minuto. È valida una sola chiave API per ogni account; quando la chiave viene rinnovata, quella precedente viene disabilitata. Il corpo della richiesta non deve superare gli 8 MB. La finestra di contesto è limitata a 100.000 token; questo indica il numero totale di token sia per il prompt che per il testo di completamento. Questi limiti sono cruciali per il funzionamento stabile dell'API.

Prezzi e gestione del credito

Sansursuz API funziona con il modello di pagamento a consumo. Vengono addebitati 0,25 $ per milione di token di input e 1,00 $ per milione di token di output. Il credito pagato viene conservato a tempo indeterminato e non ci sono costi di abbonamento. I nuovi account ricevono un credito di prova di 0,50 $ valido per 7 giorni senza necessità di carta di credito. Quando il credito termina, il servizio non viene interrotto; è sufficiente ricaricare il credito per le nuove richieste. Sono applicabili bonus del +5% per ricariche da 50 $ e del +10% per ricariche da 100 $.

Streaming

Kopyalastream = 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)