Riferimento API
Chat Completions
Modelli su questo endpoint (5)
/v1/chat/completionsL'endpoint principale: chat multi-turno, streaming, chiamata di strumenti, visione e modalità JSON per ogni modello di chat del catalogo.
#Parametri della richiesta
modelstringobbligatorioID del modello da /v1/models. Il gateway determina il fornitore upstream da questo valore.
messagesarrayobbligatorioTurni della conversazione: {role: system|user|assistant|tool, content}. content può essere una stringa o un array di parti multimodali.
streambooleanfacoltativotrue trasmette in streaming delta SSE, chiusi da data: [DONE].
temperaturenumberfacoltativoDa 0 a 2. Lascia vuoto per il valore predefinito del modello.
max_tokensintegerfacoltativoLimite massimo di token generati; limita anche la stima della quota pre-riservata.
toolsarrayfacoltativoDichiarazioni delle funzioni che il modello può chiamare — vedi la guida alla chiamata di strumenti.
tool_choicestring | objectfacoltativo"auto", "none" oppure fissa una funzione specifica.
response_formatobjectfacoltativo{"type":"json_object"} o un wrapper json_schema per output strutturati sui modelli che li supportano.
top_pnumberfacoltativoNucleus sampling; usa temperature o top_p, non entrambi.
stopstring | arrayfacoltativoFino a 4 sequenze di stop che interrompono la generazione.
#Errori correlati
- 400 invalid_request_errorCorpo malformato o parametro non supportato per questo modello.
- 401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
- 402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
- 429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
- 503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.
#Esempio di richiesta
curl https://www.aisplice.store/v1/chat/completions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-luna",
"messages": [{"role": "user", "content": "Say hello."}]
}'#Risposta
{
"id": "chatcmpl-…",
"object": "chat.completion",
"model": "gpt-5.6-luna",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "Hello!"},
"finish_reason": "stop"
}],
"usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.