Biblioteca cliente oficial de Python para acessar modelos locais e na nuvem do Ollama pelas APIs de chat, geração, embeddings e gerenciamento de modelos.
10,6 mil1,2 milPythonMITAtualizado há 4 dias
openai/openai-python
A biblioteca oficial de Python para a REST API da OpenAI, com clientes síncronos e assíncronos e modelos tipados para requisições e respostas.
- Estrelas
- 31,893
- Forks
- 8,476
- Issues abertas
- 147
- Último commit
- há 6 horas
O que é?
openai-python é o cliente oficial de Python para a REST API da OpenAI e oferece suporte ao Python 3.10 ou posterior. Ele disponibiliza clientes síncronos e assíncronos baseados em HTTPX2, com definições de tipos para todos os parâmetros de requisição e campos de resposta. A biblioteca é gerada a partir da especificação OpenAPI da OpenAI.
A interface principal é a Responses API, mas a Chat Completions API continua disponível. A biblioteca também oferece streaming por Server-Sent Events, um cliente da Realtime API via WebSockets para texto e áudio, métodos de listagem com paginação automática, upload de arquivos, verificação de assinaturas de webhooks e novas tentativas automáticas com timeouts configuráveis. As respostas são modelos Pydantic com métodos auxiliares como to_json() e to_dict().
O SDK também funciona com Azure OpenAI por meio de uma classe AzureOpenAI dedicada e com a API compatível com OpenAI do Amazon Bedrock, usando uma configuração de provedor que cuida da autenticação da AWS. A documentação também aborda a autenticação por identidade de workload para Kubernetes, Azure, GCP e TLS mútuo com X.509.
Recursos principais
- 01Clientes síncronos e assíncronos com interfaces idênticas
- 02Parâmetros de requisição tipados (TypedDict) e modelos de resposta Pydantic
- 03Respostas em streaming via Server-Sent Events
- 04Realtime API via WebSockets para texto e áudio
- 05Métodos de listagem com paginação automática e auxiliares para upload de arquivos
- 06Verificação de assinaturas de webhooks e análise de payloads
- 07Novas tentativas automáticas e timeouts configuráveis
Casos de uso
- Criar um backend em Python que chama modelos da OpenAI pela Responses API ou pela Chat Completions API
- Adicionar geração de texto em streaming a um serviço web assíncrono
- Criar aplicativos conversacionais de voz ou texto com baixa latência usando a Realtime API
- Chamar modelos da OpenAI pelo Azure OpenAI ou pelo Amazon Bedrock usando o mesmo código de cliente
Início rápido
- 1
Instale a biblioteca do PyPI
pip install openai - 2
Defina sua chave de API na variável de ambiente OPENAI_API_KEY
- 3
Crie um cliente e chame a Responses API conforme mostrado no README
Antes de usar
- Para fazer solicitações, é necessário ter uma chave de API da OpenAI e usar a API paga da OpenAI.
- É necessário usar Python 3.10 ou mais recente.
Tópicos
Perguntas frequentes
- O que é openai-python?
- A biblioteca oficial de Python para a REST API da OpenAI, com clientes síncronos e assíncronos e modelos tipados para requisições e respostas. openai-python é o cliente oficial de Python para a REST API da OpenAI e oferece suporte ao Python 3.10 ou posterior. Ele disponibiliza clientes síncronos e assíncronos baseados em HTTPX2, com definições de tipos para todos os parâmetros de requisição e campos de resposta. A biblioteca é gerada a partir da especificação OpenAPI da OpenAI.
- openai-python é gratuito? Qual é a licença?
- openai-python é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- openai-python ainda é mantido?
- Manutenção ativa. O último commit de openai-python foi em 20 de out. de 2026.
- Para que posso usar openai-python?
- Criar um backend em Python que chama modelos da OpenAI pela Responses API ou pela Chat Completions API Adicionar geração de texto em streaming a um serviço web assíncrono Criar aplicativos conversacionais de voz ou texto com baixa latência usando a Realtime API Chamar modelos da OpenAI pelo Azure OpenAI ou pelo Amazon Bedrock usando o mesmo código de cliente
- Como instalar openai-python?
- Instale a biblioteca do PyPI: pip install openai Defina sua chave de API na variável de ambiente OPENAI_API_KEY Crie um cliente e chame a Responses API conforme mostrado no README
- Onde consigo openai-python?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/openai/openai-python
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um framework Python para criar aplicações e agentes com LLMs, com interfaces padronizadas para modelos, embeddings, vector stores e integrações de terceiros.
148,1 mil24,9 milPythonMITAtualizado há 7 horas
Framework leve em Python para criar fluxos de trabalho multiagente com ferramentas, transferências, guardrails, sessões e tracing, compatível com OpenAI e mais de 100 LLMs.
30,2 mil5,1 milPythonMITAtualizado há 11 horas
SDK oficial de Python para criar servidores e clientes do Model Context Protocol que conectam aplicações com LLMs a ferramentas, dados e prompts.
24,6 mil4,3 milPythonMITAtualizado há 3 dias
Um tokenizador BPE rápido para os modelos da OpenAI, usado para converter texto em tokens e vice-versa sem perda de informação.
19,5 mil1,7 milPythonMITAtualizado há 2 meses
Ferramenta de linha de comando e biblioteca Python para executar prompts e conversar com modelos de linguagem de grande porte remotos ou instalados localmente.
12,6 mil1,1 milPythonApache-2.0Atualizado anteontem