Repolode
sashabaranov

sashabaranov/go-openai

Responses, Chat Completions, 이미지, 오디오 등을 지원하는 비공식 무의존성 Go용 OpenAI API 클라이언트입니다.

스타
10,807
포크
1,714
열린 이슈
226
마지막 커밋
지난달

어떤 프로젝트인가요?

go-openai는 OpenAI API를 위한 비공식 Go 클라이언트 라이브러리입니다. 타입이 지정된 요청 및 응답 구조체를 통해 Go 프로그램에서 Responses API, Chat Completions, 임베딩, 이미지 생성, 음성-텍스트 변환, 모더레이션, 파일, 파인튜닝, 배치 및 벡터 스토어 등의 OpenAI 서비스를 호출할 수 있습니다.

스트리밍 응답, 사용자 지정 HTTP 클라이언트와 기본 URL, Azure OpenAI 설정을 지원합니다. API에서 반환된 오류는 APIError 타입을 사용해 errors.As로 검사할 수 있습니다. 최신 OpenAI 모델용 상수를 제공하며, 패키지에 아직 정의되지 않은 모델은 모델 ID를 일반 문자열로 전달하면 됩니다.

Responses API는 새로운 텍스트 생성 및 도구 호출 통합을 시작할 때 권장되는 방식이며, 기존 코드를 위한 Chat Completions도 계속 사용할 수 있습니다. 프로젝트에는 멀티턴 응답, 함수 도구, 이미지 생성, 음성-텍스트 변환을 위한 실행 가능한 예제가 포함되어 있습니다.

핵심 기능

  • 01Responses, Chat Completions, 이미지, 오디오 및 기타 OpenAI 엔드포인트용 타입 지정 Go 구조체.
  • 02Responses와 Chat Completions 모두 스트리밍 지원.
  • 03HTTP 클라이언트, 기본 URL, 조직 및 헤더 설정 가능.
  • 04Azure OpenAI 설정 헬퍼.
  • 05errors.As와 호환되는 구조화된 API 오류.

활용 사례

  • Go 백엔드 서비스에 OpenAI 기반 텍스트 생성이나 도구 호출 기능 추가.
  • 모델 출력이 생성되는 대로 표시하는 스트리밍 채팅 인터페이스 구축.
  • Go 애플리케이션에서 이미지 생성 또는 오디오 전사.
  • 사용자 지정 기본 URL을 통해 Go 클라이언트를 OpenAI 호환 엔드포인트에 연결.

빠른 시작

  1. 1

    go get으로 라이브러리를 설치합니다

    go get github.com/sashabaranov/go-openai
  2. 2

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

    export OPENAI_API_KEY="<your key>"
  3. 3

    examples 디렉터리에서 Responses API 예제를 실행합니다

    go run ./examples/responses

사용 전 알아둘 점

  • 이 클라이언트는 비공식이며 OpenAI에서 유지 관리하지 않습니다.
  • Go 1.18 이상과 OpenAI API 키가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

go-openai은(는) 무엇인가요?
Responses, Chat Completions, 이미지, 오디오 등을 지원하는 비공식 무의존성 Go용 OpenAI API 클라이언트입니다. go-openai는 OpenAI API를 위한 비공식 Go 클라이언트 라이브러리입니다. 타입이 지정된 요청 및 응답 구조체를 통해 Go 프로그램에서 Responses API, Chat Completions, 임베딩, 이미지 생성, 음성-텍스트 변환, 모더레이션, 파일, 파인튜닝, 배치 및 벡터 스토어 등의 OpenAI 서비스를 호출할 수 있습니다.
go-openai은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
go-openai은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
go-openai은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. go-openai의 마지막 커밋은 2026년 9월 29일입니다.
go-openai은(는) 어디에 사용할 수 있나요?
Go 백엔드 서비스에 OpenAI 기반 텍스트 생성이나 도구 호출 기능 추가. 모델 출력이 생성되는 대로 표시하는 스트리밍 채팅 인터페이스 구축. Go 애플리케이션에서 이미지 생성 또는 오디오 전사. 사용자 지정 기본 URL을 통해 Go 클라이언트를 OpenAI 호환 엔드포인트에 연결.
go-openai는 어떻게 설치하나요?
go get으로 라이브러리를 설치합니다: go get github.com/sashabaranov/go-openai 환경 변수에 OpenAI API 키를 설정합니다: export OPENAI_API_KEY="<your key>" examples 디렉터리에서 Responses API 예제를 실행합니다: go run ./examples/responses
go-openai은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/sashabaranov/go-openai

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

관련 프로젝트