OpenAI API 인증 설정 가이드
OpenAI API를 통해 GPT 모델을 활용한 텍스트 생성, 이미지 생성(DALL-E), 음성 변환(Whisper, TTS) 등 다양한 AI 기능을 사용할 수 있습니다.
사전 준비
OpenAI 계정이 필요합니다.
API 사용을 위한 결제 정보 등록이 필요합니다. (유료)
API 키 발급 방법
계정 생성
OpenAI Platform에 접속하여 계정을 생성합니다.
결제 정보를 등록합니다. (**Settings** → **Billing**)
API 키 생성
API Keys 페이지로 이동합니다.
**Create new secret key**를 클릭합니다.
키 이름을 입력하고 권한을 설정합니다.
생성된 API Key를 안전하게 저장합니다. (한 번만 표시됩니다)
조직 ID 확인 선택사항
여러 조직에 속한 경우 특정 조직의 API 사용량으로 청구하려면 조직 ID가 필요합니다.
Organization Settings로 이동합니다.
**Organization ID**를 확인합니다.
워크플로우 인증 정보 입력
**필드** | **설명** | **필수** | **예시** |
|---|---|---|---|
API 키 | OpenAI API 시크릿 키 | 예 |
|
조직 ID | OpenAI 조직 ID | 아니오 |
|
기본 URL | API 엔드포인트 | 아니오 |
|
커스텀 헤더 추가 | 추가 HTTP 헤더 사용 여부 | 아니오 | 기본값: 비활성화 |
헤더 이름 | 커스텀 헤더 키 (헤더 활성화 시) | 조건부 | - |
헤더 값 | 커스텀 헤더 값 (헤더 활성화 시) | 조건부 | - |
OpenAI 호환 서비스 사용
**기본 URL**을 변경하면 OpenAI API 호환 서비스를 사용할 수 있습니다.
**서비스** | **기본 URL** |
|---|---|
OpenAI (기본) |
|
Azure OpenAI |
|
로컬 LLM(Ollama) |
|
주요 모델
**모델** | **설명** |
|---|---|
gpt-4o | 최신 멀티모달 모델 |
gpt-4o-mini | 경량 모델, 비용 효율적 |
o1 | 추론 특화 모델 |
dall-e-3 | 이미지 생성 |
whisper-1 | 음성 인식 |
tts-1 | 텍스트 음성 변환 |
시스템 증명서 사용
워크플로우에서는 *시스템 증명서*를 통해 별도의 OpenAI API 키 없이도 AI 노드를 사용할 수 있습니다.
시스템 증명서란
시스템 증명서는 플랫폼에서 공유되는 API 키입니다. 사용자가 직접 API 키를 발급받지 않아도 워크플로우에서 AI 기능을 바로 사용할 수 있습니다.
동작 방식
워크플로우 노드에서 인증 정보를 선택할 때, 사용자 본인의 인증 정보가 먼저 검색됩니다.
사용자 인증 정보가 없으면 *시스템 증명서로 자동 fallback*됩니다.
시스템 증명서를 사용한 경우, 사용량에 따라 비용이 자동 정산됩니다.
비용 안내
시스템 증명서를 사용하면 토큰 사용량 기반으로 비용이 부과됩니다. 원가에 *30% 마진*이 적용됩니다.
모델별 토큰 단가
**모델** | **입력 토큰 (1,000토큰당)** | **출력 토큰 (1,000토큰당)** |
|---|---|---|
gpt-4o | 3.5원 | 14원 |
gpt-4o-mini | 0.21원 | 0.84원 |
gpt-4.1 | 2.8원 | 11.2원 |
gpt-4.1-mini | 0.56원 | 2.24원 |
최종 청구 금액 = 원가 × 1.3 (30% 마진 포함)
비용 계산 예시
gpt-4o 모델로 입력 2,000 토큰, 출력 500 토큰을 사용한 경우입니다.
원가: (2 × 3.5) + (0.5 × 14) = 7 + 7 = 14원
최종 비용: 14 × 1.3 = 18.2원
비용 절약 팁
간단한 작업에는
gpt-4o-mini또는gpt-4.1-mini를 사용하면 비용을 크게 절감할 수 있습니다.직접 OpenAI API 키를 발급받아 사용하면 시스템 증명서 마진 없이 OpenAI 원가로 이용 가능합니다.