Vai al contenuto principale
POST
Risposta del modello

Autorizzazioni

Authorization
string
header
obbligatorio

Passaggio del token di autorizzazione nell'intestazione dell'autorizzazione: Bearer .

Intestazioni

X-Session-ID
string

ID della sessione di conversazione (alternativa al campo session_id nel corpo).

Corpo

application/json

I campi standard di OpenAI temperature, top_p, max_tokens, max_completion_tokens, stop, n e response_format sono accettati ma non applicati.

messages
object[]
obbligatorio

Un elenco dei messaggi precedenti nella conversazione.

Minimum array length: 1
model
enum<string>
predefinito:niya-1

ID modello:

  • niya-1 - Niya (modello principale per compiti generali e moderazione, contesto 1M)
  • emmy-1 - Emmy (modello intellettuale con ragionamento passo passo, contesto 1M)
  • hubert-1 - Hubert (modello personalizzato, contesto 1M)
Opzioni disponibili:
niya-1,
emmy-1,
hubert-1,
default
Esempio:

"niya-1"

files
object[]

Elenco aggiuntivo di file o immagini allegati alla richiesta.

stream
boolean
predefinito:false

Abilita lo streaming delle risposte agli eventi inviati dal server (SSE).

stream_options
object
thinking
boolean

Abilitazione della modalità di pensiero passo passo (catena di ragionamento).

Esempio:

true

surzhyk
boolean
predefinito:false

Per il modello hubert-1 include un surzhik proprietario. Per impostazione predefinita, Hubert risponde nella lingua dell'ultimo messaggio dell'utente.

effort
enum<string>

Grado di dettaglio del ragionamento (livello di riflessione):

  • low - verifica dei fatti di base;
  • medium — analisi bilanciata (predefinita);
  • high: analisi completa passo dopo passo;
  • extra / max: il massimo livello di analisi.
Opzioni disponibili:
low,
medium,
high,
extra,
max
Esempio:

"medium"

session_id
string

Identificatore della sessione di chat pubblica (UUIDv4). Consente di salvare il contesto tra le richieste.

Esempio:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

regenerate
boolean

Flag per la rigenerazione forzata dell'ultima risposta.

tools
object[]

Strumenti nel formato OpenAI. Funzionano solo con una chiave agente (sk-agent-…); con una chiave chat vengono ignorati.

tool_choice

Scelta dello strumento nel formato OpenAI.

reasoning_effort
string

Livello di ragionamento nel formato OpenAI. Uguale a effort.

Consente al modello di cercare sul web.

Risposta

Risposta del modello o flusso di blocchi (SSE) riuscita.

id
string
Esempio:

"chatcmpl-9b2f6c1e4a7d4c0e9f1a2b3c"

session_id
string
Esempio:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

object
string
Esempio:

"chat.completion"

created
integer
Esempio:

1726838400

model
string
Esempio:

"niya-1"

choices
object[]
usage
object

Consumo di token. prompt_tokens include i token in cache; total_tokens = prompt_tokens + completion_tokens. cost_credits sono i crediti IA addebitati.