Cómo funciona
Un endpoint es la combinación de una URL y un método HTTP (GET, POST, PUT, DELETE) que define una operación en una API. Es la "dirección" a la que envías la petición.
En las APIs de IA, los endpoints más comunes son: /chat/completions (generar texto), /embeddings (generar embeddings), /images/generations (generar imágenes) y /audio/transcriptions (transcribir audio). Cada uno acepta parámetros específicos y devuelve un formato de respuesta definido.
El endpoint incluye la URL base (ej.: https://api.openai.com/v1) más la ruta del recurso (ej.: /chat/completions). La URL completa es https://api.openai.com/v1/chat/completions.
Ejemplo práctico
Para llamar a la API de OpenAI y generar texto, haces un POST al endpoint https://api.openai.com/v1/chat/completions con un body JSON que contiene el modelo, los mensajes y los parámetros. La respuesta llega desde el mismo endpoint, con el texto generado.
Si usas un SDK, el endpoint se llama internamente. Si usas HTTP directo, necesitas armar la URL y los headers manualmente. En ambos casos, el endpoint es el mismo.
Para qué sirve
Sirve como punto de acceso a una funcionalidad específica de una API. Permite que los desarrolladores integren servicios de IA a su código de forma predecible y documentada.
Diferencia entre endpoint y API
La API es el conjunto completo de endpoints, reglas y autenticación de un servicio. El endpoint es un punto específico dentro de esa API. La API es el "restaurante"; el endpoint es la "mesa donde pides".