For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme

SDK와 CLI

OpenAI API로 개발할 때는 용도에 맞는 도구를 선택하세요. 애플리케이션 개발에는 SDK를, 터미널 워크플로우에는 CLI를, 오케스트레이션에는 Agents SDK를 사용하세요.

이 페이지에서는 OpenAI API로 개발하는 주요 방법을 소개합니다. 애플리케이션 코드에서는 공식 SDK를, 셸 기반 워크플로우에서는 OpenAI CLI를, 오케스트레이션에는 Agents SDK를 사용할 수 있습니다. 원하는 HTTP 클라이언트를 사용해도 됩니다.

API 키 생성 및 환경 변수로 내보내기

시작하기 전에 대시보드에서 API 키를 생성하세요. 이 키로 API에 안전하게 접근할 수 있습니다. 키는 .zshrc 파일이나 컴퓨터의 다른 텍스트 파일 등 안전한 위치에 보관하세요. API 키를 생성한 후 터미널에서 환경 변수로 내보내세요.

macOS 또는 Linux에서 환경 변수 내보내기
export OPENAI_API_KEY="your_api_key_here"

OpenAI SDK는 시스템 환경 변수에서 API 키를 자동으로 읽습니다.

공식 SDK 설치하기

Node.js, Deno, Bun과 같은 서버 측 JavaScript 환경에서 OpenAI API를 호출할 때는 공식 TypeScript 및 JavaScript용 OpenAI SDK를 사용할 수 있습니다. 먼저 npm이나 선호하는 패키지 관리자로 SDK를 설치하세요.

npm으로 OpenAI SDK 설치하기
npm install openai

OpenAI SDK를 설치한 다음 example.mjs 파일을 만들고 아래 예제 코드를 복사해 붙여 넣으세요.

기본 API 요청 테스트하기
import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6-astra",
  input: "Write a one-sentence bedtime story about a unicorn.",
});

console.log(response.output_text);

node example.mjs 명령어로 코드를 실행하세요(Deno나 Bun에서는 해당 환경에 맞는 명령어를 사용하세요). 잠시 후 API 요청 결과가 출력됩니다.

GitHub에서 자세히 알아보기

SDK의 다른 기능과 옵션은 라이브러리의 GitHub README에서 확인하세요.

Agents SDK 사용하기

API에 직접 요청을 보내려면 위에서 소개한 OpenAI 공식 SDK를 사용하세요. 애플리케이션에서 에이전트, 도구, 핸드오프, 가드레일, 트레이싱 또는 샌드박스 실행을 코드로 오케스트레이션해야 한다면 Agents SDK를 사용하세요.

API를 직접 호출할지 코드 기반 오케스트레이션을 사용할지 결정하려면 Responses API와 Agents SDK 비교를 참고하세요.

Agents SDK 빠른 시작

Agents SDK로 첫 에이전트를 만들어 보세요.

Azure OpenAI 라이브러리

Microsoft의 Azure 팀은 OpenAI API와 Azure OpenAI 서비스 모두와 호환되는 라이브러리를 관리합니다. 각 라이브러리를 OpenAI API와 함께 사용하는 방법은 아래 문서를 참고하세요.


커뮤니티 라이브러리

아래 라이브러리는 개발자 커뮤니티에서 만들고 관리합니다. GitHub에서 OpenAI의 OpenAPI 명세 리포지터리에 알림을 설정하면 API 변경 사항도 제때 확인할 수 있습니다.

OpenAI는 이러한 프로젝트의 정확성이나 보안을 검증하지 않습니다. 사용에 따른 위험은 사용자가 부담합니다!

Clojure

Dart/Flutter

Delphi

Elixir

Kotlin

PHP

Rust

Scala

Swift

Unity

Unreal Engine

기타 OpenAI 리포지터리

  • tiktoken - 토큰 수 계산
  • simple-evals - 간단한 평가 라이브러리
  • mle-bench - 머신러닝 엔지니어 역할을 수행하는 에이전트를 평가하는 라이브러리
  • gym - 강화학습 라이브러리
  • swarm - 오케스트레이션 교육용 리포지터리