Repolode
제출하기
openai

openai/openai-cli

모델, 응답, 파일, 이미지 및 관리자 엔드포인트의 리소스별 명령을 제공하는 OpenAI REST API 공식 CLI입니다.

GitHub에서 보기
스타
767
포크
79
열린 이슈
27
마지막 커밋
4시간 전

어떤 프로젝트인가요?

openai-cli는 Go로 작성된 OpenAI REST API 공식 CLI입니다. 명령을 리소스별로 구성하므로 `openai <resource> <command>` 형식으로 응답 생성, 파일 업로드 및 다운로드, 이미지 생성 등의 작업을 수행합니다. 일반 엔드포인트는 API 키로 인증하고, 관리자 엔드포인트에는 별도의 관리자 키를 사용합니다.

단순히 API를 호출하는 것 외에도 CLI는 기본적으로 읽기 편한 텍스트를 출력하며, 스크립트용 JSON, JSONL, YAML 형식도 지원합니다. `--transform` 플래그를 사용하면 GJSON 구문으로 필드를 추출할 수 있고, 오류 출력도 별도로 형식을 지정하거나 추출할 수 있습니다. 이미지 생성 결과는 로컬 디렉터리에 저장되고 파일 경로가 출력됩니다. Bash, zsh, fish, PowerShell용 셸 탭 자동 완성도 제공됩니다.

Homebrew 또는 `go install`로 설치할 수 있으며, 사용자 지정 기본 URL, 추가 요청 헤더, 이를 사용하는 조직을 위한 상호 TLS 클라이언트 인증서도 지원합니다.

핵심 기능

  • 01관리자 엔드포인트와 별도 키를 포함해 OpenAI API 엔드포인트를 리소스별 명령으로 제공합니다.
  • 02기본적으로 읽기 편한 텍스트를 출력하며, 스크립트용 JSON, JSONL, YAML 형식도 지원합니다.
  • 03GJSON 기반 `--transform`으로 응답과 오류에서 필드를 추출합니다.
  • 04이미지 생성 결과를 로컬에 저장하고 파일 경로를 출력합니다.
  • 05셸 탭 자동 완성 및 인라인 명령 제안을 지원합니다.
  • 06사용자 지정 기본 URL, 요청 헤더, 상호 TLS 클라이언트 인증서를 지원합니다.

활용 사례

  • 개발 또는 디버깅 중 터미널에서 OpenAI 모델을 호출하거나 파일을 업로드합니다.
  • 셸 파이프라인이나 CI 작업에서 JSON 출력을 파싱하는 API 워크플로를 스크립트로 작성합니다.
  • 명령줄에서 이미지를 생성하고 로컬 폴더에 저장합니다.
  • 터미널에서 조직의 관리자 사용량을 조회합니다.

빠른 시작

  1. 1

    Homebrew로 설치하기

    brew install openai/tools/openai
  2. 2

    또는 Go로 설치하기(Go 1.26 이상 필요)

    go install 'github.com/openai/openai-cli/cmd/openai@latest'
  3. 3

    환경 변수에 API 키 설정하기

    export OPENAI_API_KEY="sk-..."
  4. 4

    첫 번째 요청 실행하기(예: response 생성)

    openai responses create --input "Say this is a test" --model gpt-5.5

사용 전 알아둘 점

  • 표준 API 명령을 사용하려면 OpenAI API 키가 필요하며, 사용 요금이 발생할 수 있습니다.
  • Go로 설치하려면 Go 1.26 이상이 필요합니다.

토픽

#openai#cli#go#api-client#llm#command-line

자주 묻는 질문

openai-cli은(는) 무엇인가요?
모델, 응답, 파일, 이미지 및 관리자 엔드포인트의 리소스별 명령을 제공하는 OpenAI REST API 공식 CLI입니다. openai-cli는 Go로 작성된 OpenAI REST API 공식 CLI입니다. 명령을 리소스별로 구성하므로 `openai <resource> <command>` 형식으로 응답 생성, 파일 업로드 및 다운로드, 이미지 생성 등의 작업을 수행합니다. 일반 엔드포인트는 API 키로 인증하고, 관리자 엔드포인트에는 별도의 관리자 키를 사용합니다.
openai-cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
openai-cli은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
openai-cli은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. openai-cli의 마지막 커밋은 2026년 10월 22일입니다.
openai-cli은(는) 어디에 사용할 수 있나요?
개발 또는 디버깅 중 터미널에서 OpenAI 모델을 호출하거나 파일을 업로드합니다. 셸 파이프라인이나 CI 작업에서 JSON 출력을 파싱하는 API 워크플로를 스크립트로 작성합니다. 명령줄에서 이미지를 생성하고 로컬 폴더에 저장합니다. 터미널에서 조직의 관리자 사용량을 조회합니다.
openai-cli는 어떻게 설치하나요?
Homebrew로 설치하기: brew install openai/tools/openai 또는 Go로 설치하기(Go 1.26 이상 필요): go install 'github.com/openai/openai-cli/cmd/openai@latest' 환경 변수에 API 키 설정하기: export OPENAI_API_KEY="sk-..." 첫 번째 요청 실행하기(예: response 생성): openai responses create --input "Say this is a test" --model gpt-5.5
openai-cli은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openai/openai-cli

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

관련 프로젝트