Repolode
openai

openai/openai-go

Responses, Chat Completions, Realtime 등을 지원하는 OpenAI REST API 공식 Go 클라이언트 라이브러리입니다.

스타
3,531
포크
361
열린 이슈
87
마지막 커밋
4시간 전

어떤 프로젝트인가요?

openai-go는 OpenAI REST API를 위한 공식 Go 라이브러리입니다. 직접 HTTP 호출을 구성하는 대신 타입이 지정된 요청 및 응답 구조체를 사용해 Go 애플리케이션에서 OpenAI 엔드포인트를 호출할 수 있습니다. 주요 진입점은 Responses API이며, 텍스트 생성, 멀티턴 대화, 스트리밍, 도구 호출, 구조화된 출력 기능을 위한 헬퍼를 제공합니다. Chat Completions API도 지원합니다.

이 라이브러리는 텍스트 생성 외에도 다양한 기능을 제공합니다. Responses API용 WebSocket 연결, 타입이 지정된 Realtime 및 Live 연결, 목록 엔드포인트용 페이지네이션 헬퍼, io.Reader를 통한 파일 업로드, 페이로드 파싱을 지원하는 웹훅 서명 검증 기능이 포함됩니다. 요청에는 헤더, 타임아웃, 재시도를 위한 함수형 옵션을 사용할 수 있으며, 오류는 프로그래밍 방식으로 처리할 수 있도록 *openai.Error로 반환됩니다.

이 모듈을 사용하려면 Go 1.26 이상이 필요하며, README에는 이전 Go 툴체인용으로 고정된 버전이 안내되어 있습니다.

핵심 기능

  • 01Responses 및 Chat Completions API 호출에 사용하는 타입이 지정된 Go 구조체.
  • 02스트리밍 응답 및 도구(함수) 호출 헬퍼.
  • 03Go 타입에서 생성한 JSON schema를 사용하는 구조화된 출력.
  • 04Responses용 WebSocket 연결과 타입이 지정된 Realtime 및 Live 연결.
  • 05목록 엔드포인트용 자동 페이지네이션 헬퍼 및 웹훅 서명 검증.

활용 사례

  • Go 백엔드 서비스에 LLM 텍스트 생성 또는 채팅 기능 추가.
  • 응답 ID를 통해 대화 상태를 유지하는 멀티턴 어시스턴트 구축.
  • JSON schema를 사용해 모델 출력에서 타입이 지정된 데이터 추출.
  • Go 서버에서 OpenAI 웹훅 이벤트 수신 및 검증.

빠른 시작

  1. 1

    SDK를 지정한 버전으로 설치합니다

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

    환경 변수 OPENAI_API_KEY에 OpenAI API 키를 설정합니다

  3. 3

    클라이언트를 생성하고 README의 Responses 예제 코드를 사용해 client.Responses.New를 호출합니다

사용 전 알아둘 점

  • Go 1.26 이상이 필요합니다. 이전 툴체인을 사용하는 경우 이전 SDK 릴리스 버전을 고정해야 합니다.
  • 최신 버전에는 범위가 제한된 소규모 호환성 변경이 있으므로 업그레이드하기 전에 변경 로그를 확인하세요.
  • js/wasm 빌드에서는 Responses WebSockets를 사용할 수 없습니다.

포함된 컬렉션

토픽

자주 묻는 질문

openai-go은(는) 무엇인가요?
Responses, Chat Completions, Realtime 등을 지원하는 OpenAI REST API 공식 Go 클라이언트 라이브러리입니다. openai-go는 OpenAI REST API를 위한 공식 Go 라이브러리입니다. 직접 HTTP 호출을 구성하는 대신 타입이 지정된 요청 및 응답 구조체를 사용해 Go 애플리케이션에서 OpenAI 엔드포인트를 호출할 수 있습니다. 주요 진입점은 Responses API이며, 텍스트 생성, 멀티턴 대화, 스트리밍, 도구 호출, 구조화된 출력 기능을 위한 헬퍼를 제공합니다. Chat Completions API도 지원합니다.
openai-go은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
openai-go은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
openai-go은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. openai-go의 마지막 커밋은 2026년 11월 7일입니다.
openai-go은(는) 어디에 사용할 수 있나요?
Go 백엔드 서비스에 LLM 텍스트 생성 또는 채팅 기능 추가. 응답 ID를 통해 대화 상태를 유지하는 멀티턴 어시스턴트 구축. JSON schema를 사용해 모델 출력에서 타입이 지정된 데이터 추출. Go 서버에서 OpenAI 웹훅 이벤트 수신 및 검증.
openai-go는 어떻게 설치하나요?
SDK를 지정한 버전으로 설치합니다: go get -u 'github.com/openai/openai-go/v3@v3.96.0' 환경 변수 OPENAI_API_KEY에 OpenAI API 키를 설정합니다 클라이언트를 생성하고 README의 Responses 예제 코드를 사용해 client.Responses.New를 호출합니다
openai-go은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openai/openai-go

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트