Avvio rapido: integra in pochi minuti

1. Installa il tuo SDK

Inizia installando la libreria ufficiale per il tuo linguaggio. La maggior parte degli sviluppatori preferisce il pacchetto standard perché corrisponde all'interfaccia che già conosce. Esegui pip install openai per Python o npm install openai per Node.js. Hai bisogno di un solo SDK per gestire tutte le richieste.

2. Imposta il tuo URL di base

Configura il tuo client per puntare al nostro endpoint specifico. Devi sovrascrivere l'URL base predefinito per instradare correttamente il traffico. Usa https://api.unsencoredai.com/v1 come tuo URL di base. Passa la tua chiave API in Authorization header. Questa configurazione funziona con qualsiasi client compatibile con OpenAI standard.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Inviare la tua prima richiesta

Invia una richiesta standard di completamento chat per generare testo. L'ID del modello è uncensored. Puoi inviare prompt di sistema per guidare il comportamento. L'API restituisce una risposta testuale diretta. Usa il comando curl qui sotto per testare la connettività immediatamente. Controlla la tua risposta per il choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Gestisci le risposte in streaming

Abilita lo streaming per una latenza inferiore e output in tempo reale. Imposta stream: true nella tua richiesta. L'API invia chunk tramite Server-Sent Events. Puoi elaborare ogni token man mano che arriva. Questo è ideale per interfacce chat o scenari di roleplay. L'ultimo chunk contiene le statistiche di utilizzo.

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

5. Configura i parametri

Regola temperature, top_p, e stop sequenze. Questi controlli influenzano la creatività e la lunghezza dell'output. Puoi anche usare response_format per la modalità JSON. La finestra di contesto supporta 100,000 token totali. L'output massimo è 16,000 token per richiesta. Sintonizza queste impostazioni per il tuo caso d'uso specifico.

6. Limiti, errori e contesto

Gestisci gli errori in modo elegante utilizzando i codici di stato HTTP standard. Un errore 401 significa che la tua chiave API non è valida. Un errore 402 indica crediti prepagati insufficienti. Un errore 429 segnala che hai raggiunto il limite di 300 richieste al minuto. La tua finestra di contesto è di 100.000 token. Le richieste superiori a 8 MB potrebbero fallire. I rimborsi non vengono emessi per il credito, ma gli errori sono gratuiti.