---
title: "Cos’è la Chat Completions API? L’endpoint chat /v1 | BroadRouter"
description: "La Chat Completions API riceve una lista di messaggi con ruolo e restituisce la risposta del modello. Come funziona e perché tanti provider la copiano."
url: https://broadrouter.com/it/glossary/chat-completions-api/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/glossary/chat-completions-api/) (aggiornato il 2026-11-16).

# Chat Completions API

Aggiornato 2026-11-16

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

Detto anche: Chat Completions, API Chat Completions, endpoint chat completions, /v1/chat/completions, chat.completions.create, chat completions endpoint

Gran parte del codice LLM in circolazione parla un solo dialetto: una lista di messaggi in ingresso, un messaggio in uscita. Quel dialetto è la Chat Completions API.

## Come funziona

Fai una POST di JSON a `/v1/chat/completions` con un `model` e un array `messages`. Ogni messaggio ha un `role` (`system`, `user`, `assistant` o `tool`) e un `content`. La risposta contiene un array `choices`; ogni choice porta un `message` e un [finish\_reason](https://broadrouter.com/it/glossary/finish-reason/) che dice perché la generazione è finita, più un blocco `usage` con il conteggio dei token.

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b",
       "messages":[{"role":"system","content":"Answer in one line."},
                   {"role":"user","content":"What is a token?"}]}'
```

Nell’SDK Python di OpenAI la stessa chiamata è `client.chat.completions.create(...)`. I campi facoltativi modellano l’output: `max_tokens`, `temperature`, `stream`, `tools`, `response_format` e altri.

L’API è stateless. La guida alla migrazione di OpenAI dice che in Chat Completions “conversation state must be managed manually” (traduzione: lo stato della conversazione va gestito manualmente): è il tuo codice a tenere la cronologia e a rinviarla a ogni turno. La più recente Responses API di OpenAI usa elementi tipizzati e può mantenere lo stato lato server, e OpenAI la consiglia per i nuovi progetti sulla propria piattaforma, ma dice che Chat Completions “remains supported” (resta supportata).

## Perché è importante

-   **Portabilità.** Un’[API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/) di solito indica proprio questo endpoint. Cambiare provider spesso significa solo un nuovo [base URL](https://broadrouter.com/it/glossary/base-url/), una nuova chiave e un nuovo nome di modello.
-   **Costo.** Dato che l’intera cronologia viene rinviata, i token di input crescono a ogni turno. Accorcia o riassumi le chat lunghe.
-   **Campi che divergono.** Non tutti i provider compatibili accettano ogni campo di OpenAI. I campi sconosciuti possono essere ignorati o rifiutati, quindi prova quelli da cui dipendi.

## Su BroadNet Inference

BroadNet serve la chat con POST /v1/chat/completions su `https://inference.broadnet.ai/v1`, per DeepSeek V4.1 Flash, [GLM 5.3](https://broadrouter.com/it/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/it/models/qwen3.8-27b/) e [Gemma 4 VL 26B](https://broadrouter.com/it/models/gemma-4-vl-26b/). Lo [streaming](https://broadrouter.com/it/glossary/streaming/) usa `stream=true` e termina con `data: [DONE]`. Tool calling e output strutturato sono documentati solo per GLM 5.3 e Qwen3.8 27B. Il [riferimento API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-chat-completions-api&utm_content=body) di BroadNet non documenta un endpoint Responses, quindi usa Chat Completions. Parti dal [quickstart con curl](https://broadrouter.com/it/guides/curl-quickstart/) o dalla [guida all’SDK Python](https://broadrouter.com/it/guides/openai-python-sdk/).

## Errori comuni

-   Inviare solo l’ultimo messaggio dell’utente aspettandosi che il modello ricordi la chat.
-   Copiare campi esclusivi di OpenAI su un altro provider senza controllarne il riferimento.

## Domande frequenti

### La Chat Completions API è deprecata?

No. La guida alla migrazione di OpenAI dice "Chat Completions remains supported" (Chat Completions resta supportata), anche se per i nuovi progetti su OpenAI consiglia la più recente Responses API.

### La Chat Completions API ricorda i messaggi precedenti?

No. È stateless. La guida di OpenAI dice che lo stato della conversazione "must be managed manually" (va gestito manualmente), quindi invii l’intera cronologia dei messaggi a ogni richiesta.

### Quale endpoint usa BroadNet Inference per la chat?

POST /v1/chat/completions sul base URL https://inference.broadnet.ai/v1. BroadNet non documenta un endpoint della Responses API.

## Vedi anche

-   [API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/) (termine)
-   [Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/) (termine)
-   [Streaming](https://broadrouter.com/it/glossary/streaming/) (termine)
-   [finish\_reason](https://broadrouter.com/it/glossary/finish-reason/) (termine)
-   [Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/) (termine)
-   [System prompt (prompt di sistema)](https://broadrouter.com/it/glossary/system-prompt/) (termine)
-   [Token immagine (image tokens)](https://broadrouter.com/it/glossary/image-tokens/) (termine)
-   [Prima richiesta a BroadNet Inference con curl](https://broadrouter.com/it/guides/curl-quickstart/) (guida)
-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/) (guida)
-   [Streaming delle chat completions e connessioni interrotte](https://broadrouter.com/it/guides/streaming-chat-completions/) (guida)
-   [Migrare dall’API di OpenAI: il codice in Python, Node e cURL](https://broadrouter.com/it/blog/migrate-from-openai-api-code-walkthrough/) (articolo)
-   [Passare a un’API compatibile con OpenAI: la checklist di migrazione](https://broadrouter.com/it/blog/openai-compatible-api-migration-checklist/) (articolo)

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-chat-completions-api&utm_content=page-cta) ·

**Fonti**

-   [Riferimento API di OpenAI, creare una chat completion (verificato il 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, migrare alla Responses API (verificato il 2026-11-15)](https://developers.openai.com/api/docs/guides/migrate-to-responses)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-chat-completions-api&utm_content=sources)
