Torna alle guide

Le API, nel dettaglio.

Endpoint, esempi e parametri da consultare mentre programmi. Usa il tuo client compatibile OpenAI e collegalo a Uncensured AI.

POST/v1/chat/completions

Genera una risposta

Invia la conversazione in messages e scegli il modello con il suo ID esatto. Questi esempi usano GLM 5.3 Flash.

Installa il pacchetto openai e imposta UNCENSURED_API_KEY come nella guida alla prima richiesta.

Python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://uncensuredai.com/v1",
    api_key=os.environ["UNCENSURED_API_KEY"],
)

response = client.chat.completions.create(
    model="glm-5.3-flash-abliterated",
    messages=[{"role": "user", "content": "Scrivi un breve saluto in italiano."}],
    reasoning_effort="low",
    max_tokens=4096,
)

print(response.choices[0].message.content)

I campi dell’esempio

CampoCome usarlo
modelUn ID esatto restituito da GET /v1/models per la tua chiave.
messagesLa lista dei messaggi, ciascuno con role e content.
max_tokensIl budget di output, che può includere i token di ragionamento. L’esempio usa 4096.
reasoning_effortUn livello supportato dal modello scelto. Nell’esempio GLM Flash usa low.
streamImpostalo a true per ricevere la risposta in parti successive.

La compatibilità OpenAI riguarda Chat Completions. Immagini, strumenti, limiti di contesto e opzioni di ragionamento dipendono dal modello e dal client.

Leggi la risposta

Il testo generato si trova in choices[0].message.content. Controlla finish_reason per sapere come si è conclusa la generazione e usage per i token riportati.

Python · dopo la richiesta
print(response.choices[0].message.content)
print(response.choices[0].finish_reason)
print(response.usage)
POST/v1/chat/completions

Mostra il testo mentre arriva

Riutilizza il client dell’esempio Python e attiva lo streaming. Ogni evento può contenere soltanto una parte della risposta.

Python · streaming
stream = client.chat.completions.create(
    model="glm-5.3-flash-abliterated",
    messages=[{"role": "user", "content": "Ciao!"}],
    reasoning_effort="low",
    max_tokens=4096,
    stream=True,
)

for chunk in stream:
    if chunk.choices:
        text = chunk.choices[0].delta.content
        if text:
            print(text, end="", flush=True)
print()

Alcuni eventi non contengono testo. Controlla choices e delta.content prima di mostrare una parte della risposta.

GET/v1/models

Trova i modelli disponibili per la tua chiave

Riutilizza il client Python per elencare gli ID dei modelli. Questo controllo verifica la connessione senza generare una risposta.

Python · models
models = client.models.list()
for model in models.data:
    print(model.id)

L’elenco ottenuto con la tua chiave indica i modelli disponibili. Il catalogo pubblico delle capacità descrive invece limiti confermati e impostazioni di ragionamento.

Apri il catalogo delle capacità
Una richiesta non è andata a buon fine?Trova l’errore e il prossimo passo

Uncensured AI

Loading...