Repolode
Enviar
openai

openai/openai-go

A biblioteca oficial de cliente Go para a REST API da OpenAI, com suporte a Responses, Chat Completions, Realtime e muito mais.

Ver no GitHub
Estrelas
3,531
Forks
361
Issues abertas
87
Último commit
há 6 horas

O que é?

openai-go é a biblioteca oficial de Go para a REST API da OpenAI. Ela permite que aplicações Go chamem endpoints da OpenAI usando structs tipadas para requisições e respostas, em vez de montar chamadas HTTP manualmente. O principal ponto de entrada é a Responses API, com helpers para gerar texto, criar conversas com várias interações, fazer streaming, chamar tools e gerar saídas estruturadas. A Chat Completions API também é compatível.

A biblioteca vai além da geração de texto. Ela inclui conexões WebSocket para a Responses API, conexões tipadas Realtime e Live, helpers de paginação para endpoints de listagem, uploads de arquivos via io.Reader e verificação de assinaturas de webhook com parsing do payload. As requisições usam opções funcionais para configurar headers, timeouts e retries, e os erros são retornados como *openai.Error para tratamento programático.

O módulo requer Go 1.26 ou posterior, e o README informa versões fixadas para toolchains Go mais antigas.

Recursos principais

  • 01Structs tipadas em Go para chamadas às APIs Responses e Chat Completions.
  • 02Respostas em streaming e helpers para chamada de tools (funções).
  • 03Saídas estruturadas com JSON schema gerado a partir de tipos Go.
  • 04Conexões WebSocket para Responses, além de conexões tipadas Realtime e Live.
  • 05Helpers de paginação automática para endpoints de listagem e verificação de assinaturas de webhook.

Casos de uso

  • Adicionar geração de texto com LLM ou chat a um serviço backend em Go.
  • Criar assistentes com várias interações que mantêm o estado da conversa usando IDs de resposta.
  • Extrair dados tipados das respostas do modelo usando JSON schema.
  • Receber e verificar eventos de webhook da OpenAI em um servidor Go.

Início rápido

  1. 1

    Instale o SDK em uma versão específica

    go get -u 'github.com/openai/openai-go/v3@v3.96.0'
  2. 2

    Defina sua chave de API da OpenAI na variável de ambiente OPENAI_API_KEY

  3. 3

    Crie um cliente e chame client.Responses.New usando o código de exemplo de Responses do README

Antes de usar

  • É necessário usar Go 1.26 ou posterior; com toolchains mais antigos, fixe uma versão anterior do SDK.
  • A versão mais recente inclui pequenas mudanças incompatíveis e de escopo limitado, então consulte o changelog antes de atualizar.
  • Responses WebSockets não está disponível em builds js/wasm.

Em coleções

Ferramentas de streaming

Tópicos

#openai#llm#go-sdk#api-client#streaming#tool-calling#webhooks

Perguntas frequentes

O que é openai-go?
A biblioteca oficial de cliente Go para a REST API da OpenAI, com suporte a Responses, Chat Completions, Realtime e muito mais. openai-go é a biblioteca oficial de Go para a REST API da OpenAI. Ela permite que aplicações Go chamem endpoints da OpenAI usando structs tipadas para requisições e respostas, em vez de montar chamadas HTTP manualmente. O principal ponto de entrada é a Responses API, com helpers para gerar texto, criar conversas com várias interações, fazer streaming, chamar tools e gerar saídas estruturadas. A Chat Completions API também é compatível.
openai-go é gratuito? Qual é a licença?
openai-go é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
openai-go ainda é mantido?
Manutenção ativa. O último commit de openai-go foi em 7 de nov. de 2026.
Para que posso usar openai-go?
Adicionar geração de texto com LLM ou chat a um serviço backend em Go. Criar assistentes com várias interações que mantêm o estado da conversa usando IDs de resposta. Extrair dados tipados das respostas do modelo usando JSON schema. Receber e verificar eventos de webhook da OpenAI em um servidor Go.
Como instalar openai-go?
Instale o SDK em uma versão específica: go get -u 'github.com/openai/openai-go/v3@v3.96.0' Defina sua chave de API da OpenAI na variável de ambiente OPENAI_API_KEY Crie um cliente e chame client.Responses.New usando o código de exemplo de Responses do README
Onde consigo openai-go?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/openai/openai-go

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados