Biblioteca cliente oficial de Python para usar los modelos locales y en la nube de Ollama mediante APIs de chat, generación, embeddings y gestión de modelos.
10,6 mil1,2 milPythonMITActualizado hace 4 días
openai/openai-python
La biblioteca oficial de Python para la API REST de OpenAI, con clientes síncronos y asíncronos y modelos tipados para solicitudes y respuestas.
- Estrellas
- 31,893
- Forks
- 8,476
- Issues abiertos
- 147
- Último commit
- hace 6 horas
¿Qué es?
openai-python es el cliente oficial de Python para la API REST de OpenAI y es compatible con Python 3.10 y versiones posteriores. Ofrece clientes síncronos y asíncronos basados en HTTPX2, con definiciones de tipos para todos los parámetros de solicitud y los campos de respuesta. La biblioteca se genera a partir de la especificación OpenAPI de OpenAI.
La interfaz principal es la API Responses, aunque la API Chat Completions sigue siendo compatible. La biblioteca también incluye streaming mediante Server-Sent Events, un cliente de la API Realtime sobre WebSockets para texto y audio, métodos de listas con paginación automática, carga de archivos, verificación de firmas de webhooks y reintentos automáticos con tiempos de espera configurables. Las respuestas son modelos Pydantic con utilidades como to_json() y to_dict().
El SDK también funciona con Azure OpenAI mediante una clase específica, AzureOpenAI, y con la API compatible con OpenAI de Amazon Bedrock mediante una configuración de proveedor que gestiona la autenticación de AWS. También se documenta la autenticación de identidad de carga de trabajo para Kubernetes, Azure, GCP y TLS mutuo con X.509.
Funciones clave
- 01Clientes síncronos y asíncronos con interfaces idénticas
- 02Parámetros de solicitud tipados (TypedDict) y modelos de respuesta Pydantic
- 03Respuestas en streaming mediante Server-Sent Events
- 04API Realtime sobre WebSockets para texto y audio
- 05Métodos de listas con paginación automática y utilidades para cargar archivos
- 06Verificación de firmas de webhooks y análisis de sus cargas útiles
- 07Reintentos automáticos y tiempos de espera configurables
Casos de uso
- Crear un backend de Python que invoque modelos de OpenAI mediante la API Responses o Chat Completions
- Añadir generación de texto en streaming a un servicio web asíncrono
- Crear aplicaciones conversacionales de voz o texto de baja latencia con la API Realtime
- Invocar modelos de OpenAI desde Azure OpenAI o Amazon Bedrock con el mismo código de cliente
Inicio rápido
- 1
Instala la biblioteca desde PyPI
pip install openai - 2
Configura tu clave de API en la variable de entorno OPENAI_API_KEY
- 3
Crea un cliente y llama a la Responses API como se muestra en el README
Antes de usarlo
- Para realizar solicitudes, necesitas una clave de API de OpenAI y usar la API de pago de OpenAI.
- Se requiere Python 3.10 o posterior.
Temas
Preguntas frecuentes
- ¿Qué es openai-python?
- La biblioteca oficial de Python para la API REST de OpenAI, con clientes síncronos y asíncronos y modelos tipados para solicitudes y respuestas. openai-python es el cliente oficial de Python para la API REST de OpenAI y es compatible con Python 3.10 y versiones posteriores. Ofrece clientes síncronos y asíncronos basados en HTTPX2, con definiciones de tipos para todos los parámetros de solicitud y los campos de respuesta. La biblioteca se genera a partir de la especificación OpenAPI de OpenAI.
- ¿openai-python es gratuito? ¿Qué licencia tiene?
- openai-python es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿openai-python sigue mantenido?
- Mantenimiento activo. El último commit de openai-python fue el 20 oct 2026.
- ¿Para qué puedo usar openai-python?
- Crear un backend de Python que invoque modelos de OpenAI mediante la API Responses o Chat Completions Añadir generación de texto en streaming a un servicio web asíncrono Crear aplicaciones conversacionales de voz o texto de baja latencia con la API Realtime Invocar modelos de OpenAI desde Azure OpenAI o Amazon Bedrock con el mismo código de cliente
- ¿Cómo se instala openai-python?
- Instala la biblioteca desde PyPI: pip install openai Configura tu clave de API en la variable de entorno OPENAI_API_KEY Crea un cliente y llama a la Responses API como se muestra en el README
- ¿Dónde consigo openai-python?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/openai/openai-python
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Framework de Python para crear aplicaciones y agentes basados en LLM, con interfaces estándar para modelos, embeddings, almacenes vectoriales e integraciones de terceros.
148,1 mil24,9 milPythonMITActualizado hace 7 horas
Framework ligero de Python para crear flujos de trabajo multiagente con herramientas, transferencias, guardrails, sesiones y trazas, compatible con OpenAI y más de 100 LLMs.
30,2 mil5,1 milPythonMITActualizado hace 11 horas
SDK oficial de Python para crear servidores y clientes de Model Context Protocol que conectan aplicaciones con LLM con herramientas, datos y prompts.
24,6 mil4,3 milPythonMITActualizado hace 3 días
Un tokenizador BPE rápido para los modelos de OpenAI, que convierte texto en tokens y lo reconstruye sin pérdida.
19,5 mil1,7 milPythonMITActualizado hace 2 meses
Herramienta de línea de comandos y biblioteca de Python para ejecutar prompts y chats con modelos de lenguaje grandes, remotos o instalados localmente.
12,6 mil1,1 milPythonApache-2.0Actualizado anteayer