---
title: "¿Qué es la API de Chat Completions? El endpoint /v1 de chat"
description: "La API de Chat Completions recibe mensajes con roles y devuelve la respuesta del modelo. Cómo funcionan la solicitud y la respuesta, y por qué tantos la copian."
url: https://broadrouter.com/es/glossary/chat-completions-api/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/glossary/chat-completions-api/) (actualizado el 2026-11-16).

# API de Chat Completions

Actualizado 2026-11-16

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

También llamado: API de Chat Completions, endpoint de chat completions, completado de chat, Chat Completions, chat completions endpoint, /v1/chat/completions, chat.completions.create

La mayor parte del código de LLM que circula habla un mismo dialecto: entra una lista de mensajes y sale un mensaje. Ese dialecto es la API de Chat Completions.

## Cómo funciona

Usted hace un POST con JSON a `/v1/chat/completions` con un `model` y un array `messages`. Cada mensaje tiene un `role` (`system`, `user`, `assistant` o `tool`) y un `content`. La respuesta contiene un array `choices`; cada opción lleva un `message` y un [finish\_reason](https://broadrouter.com/es/glossary/finish-reason/) que indica por qué terminó la generación, además de un bloque `usage` con el conteo de tokens.

```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?"}]}'
```

En el SDK de OpenAI para Python, la misma llamada es `client.chat.completions.create(...)`. Los campos opcionales dan forma a la salida: `max_tokens`, `temperature`, `stream`, `tools`, `response_format` y otros.

La API no tiene estado. La guía de migración de OpenAI dice que en Chat Completions “conversation state must be managed manually” (traducción: el estado de la conversación debe gestionarse manualmente): su código guarda el historial y lo vuelve a enviar en cada turno. La Responses API, más reciente, usa elementos tipados y puede mantener el estado en el servidor; OpenAI la recomienda para proyectos nuevos en su propia plataforma, pero afirma que Chat Completions “remains supported” (traducción: sigue siendo compatible).

## Por qué importa

-   **Portabilidad.** Una [API compatible con OpenAI](https://broadrouter.com/es/glossary/openai-compatible-api/) suele significar este endpoint. Cambiar de proveedor a menudo se reduce a una nueva [URL base](https://broadrouter.com/es/glossary/base-url/), una clave y un nombre de modelo.
-   **Costo.** Como se reenvía todo el historial, los tokens de entrada crecen en cada turno. Recorte o resuma los chats largos.
-   **Diferencias de campos.** No todos los proveedores compatibles aceptan todos los campos de OpenAI. Los campos desconocidos pueden ignorarse o rechazarse, así que pruebe los que necesita.

## En BroadNet Inference

BroadNet sirve el chat en POST /v1/chat/completions sobre `https://inference.broadnet.ai/v1`, para DeepSeek V4.1 Flash, [GLM 5.3](https://broadrouter.com/es/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/es/models/qwen3.8-27b/) y [Gemma 4 VL 26B](https://broadrouter.com/es/models/gemma-4-vl-26b/). El [streaming](https://broadrouter.com/es/glossary/streaming/) usa `stream=true` y termina con `data: [DONE]`. Tool calling y la salida estructurada están documentados solo para GLM 5.3 y Qwen3.8 27B. La [referencia de la API de BroadNet](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-chat-completions-api&utm_content=body) no documenta un endpoint de Responses, así que use Chat Completions. Empiece con el [inicio rápido con curl](https://broadrouter.com/es/guides/curl-quickstart/) o la [guía del SDK para Python](https://broadrouter.com/es/guides/openai-python-sdk/).

## Errores comunes

-   Enviar solo el último mensaje del usuario y esperar que el modelo recuerde la conversación.
-   Copiar campos exclusivos de OpenAI a otro proveedor sin revisar su referencia.

## Preguntas frecuentes

### ¿La API de Chat Completions está obsoleta?

No. La guía de migración de OpenAI dice que "Chat Completions remains supported" (traducción: Chat Completions sigue siendo compatible), aunque recomienda la Responses API, más reciente, para proyectos nuevos en OpenAI.

### ¿La API de Chat Completions recuerda los mensajes anteriores?

No. No tiene estado (stateless). La guía de OpenAI dice que el estado de la conversación "must be managed manually" (traducción: debe gestionarse manualmente), así que usted envía el historial completo de mensajes en cada solicitud.

### ¿Qué endpoint usa BroadNet Inference para el chat?

POST /v1/chat/completions en la URL base https://inference.broadnet.ai/v1. BroadNet no documenta un endpoint de la Responses API.

## Vea también

-   [API compatible con OpenAI](https://broadrouter.com/es/glossary/openai-compatible-api/) (término)
-   [URL base (base URL)](https://broadrouter.com/es/glossary/base-url/) (término)
-   [Streaming (respuestas en tiempo real)](https://broadrouter.com/es/glossary/streaming/) (término)
-   [finish\_reason (motivo de finalización)](https://broadrouter.com/es/glossary/finish-reason/) (término)
-   [Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/) (término)
-   [Prompt de sistema (system prompt)](https://broadrouter.com/es/glossary/system-prompt/) (término)
-   [Tokens de imagen (image tokens)](https://broadrouter.com/es/glossary/image-tokens/) (término)
-   [Primera solicitud a BroadNet Inference con curl](https://broadrouter.com/es/guides/curl-quickstart/) (guía)
-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/) (guía)
-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/) (guía)
-   [Migrar desde la API de OpenAI: el código en Python, Node y cURL](https://broadrouter.com/es/blog/migrate-from-openai-api-code-walkthrough/) (artículo)
-   [Cambiar a una API compatible con OpenAI: lista de verificación](https://broadrouter.com/es/blog/openai-compatible-api-migration-checklist/) (artículo)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

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

**Fuentes**

-   [Referencia de la API de OpenAI, crear chat completion (consultado el 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, migrar a la Responses API (consultado el 2026-11-15)](https://developers.openai.com/api/docs/guides/migrate-to-responses)
-   [Referencia de la API de BroadNet Inference (consultado el 2026-11-15) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-chat-completions-api&utm_content=sources)
