Documentazione API

Avvio rapido: Connetti in 3 righe

La nostra API funziona esattamente come l'interfaccia standard chat-completions che già conosci. Basta puntare il tuo client al nostro URL di base e fornire la tua chiave API. Nessun routing complesso o peculiarità specifiche del fornitore. Pensiamo noi al resto.

L'URL di base per tutte le richieste è https://api.toolsaiuncensored.com/v1. Puoi utilizzare qualsiasi SDK ufficiale o libreria compatibile aggiornando la configurazione dell'URL di base. L'autenticazione si basa su un singolo token bearer fornito tramite il Authorization header. Questo garantisce un'integrazione fluida con il tuo stack esistente.

Copycurl https://api.toolsaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "run unit tests on the legacy auth module"}]
  }'

Endpoint: Chat Completions & Models

Espone solo gli endpoint essenziali per la generazione di testo. Il POST /v1/chat/completions endpoint elabora i tuoi prompt e restituisce il testo generato. Usa GET /v1/models a verificare l'ID del modello disponibile. Non offriamo servizi di embedding, generazione di immagini, elaborazione audio o fine-tuning. Mantieni la tua infrastruttura semplice.

L'ID del modello che devi inviare è uncensored. Questo è il nostro modello open-weight ottimizzato, non un'istanza GPT o Claude rivenduta. Risponde direttamente senza filtri di contenuto per l'uso adulto lecito. Consulta la documentazione dell'endpoint per le strutture di payload specifiche.

Copyfrom openai import OpenAI

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

Parametri: Temperatura, Top P e Seed

Controlla la creatività e il determinismo dei tuoi output utilizzando parametri standard. Regola temperature a variare la casualità. Imposta top_p per limitare il campionamento del nucleo. Utilizza seed per risultati riproducibili. Questi strumenti ti offrono un controllo preciso sul processo di generazione del testo.

Puoi anche impostare presence_penalty e frequency_penalty per influenzare la ripetizione dei token. Il stop parameter ti permette di definire sequenze di terminazione personalizzate. Questo livello di controllo garantisce che l'output corrisponda al tuo caso d'uso specifico. Configura questi valori nel corpo della richiesta.

Copyimport OpenAI from "openai";

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

Modalità Streaming & JSON

Ricevi risposte in tempo reale utilizzando Server-Sent Events (SSE). Lo streaming riduce significativamente la latenza percepita. Ogni chunk include dati di utilizzo dei token nell'evento finale. Ciò consente un tracciamento accurato del fatturato durante le generazioni lunghe.

Per dati strutturati, abilita la modalità JSON impostando response_format a {"type": "json_object"}. Il modello cercherà di outputare JSON valido. Questo è ideale per le pipeline programmatiche. Combina lo streaming con la modalità JSON per un'estrazione efficiente di dati strutturati senza errori di analisi.

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)

Supporto al Function Calling

Definisci gli strumenti nella richiesta per consentire al modello di chiamare funzioni dinamicamente. Specifica tools e tool_choice per controllare l'esecuzione. Il modello restituisce chiamate di strumenti nel flusso di risposta. Questo abilita flussi di lavoro complessi e comportamenti simili ad agenti.

Passa le definizioni delle funzioni in messages array. Il modello invocherà lo strumento appropriato in base al contesto del tuo prompt. Puoi quindi eseguire la funzione localmente e alimentare il risultato nella conversazione. Questo supporta modelli avanzati di automazione.

Limiti di frequenza e vincoli

La tua chiave API consente 300 richieste al minuto. Puoi eseguire 8 richieste simultanee. La dimensione massima del corpo della richiesta è di 8 MB. Ogni chiave è associata a un account; generare una nuova chiave sostituisce quella vecchia.

La finestra di contesto supporta un totale di 100.000 token, inclusi input e output. L'output massimo per richiesta è di 16.000 token. Se non specifichi max_tokens, il limite predefinito è 2.048 token. Monitora il tuo utilizzo per rimanere entro questi limiti.