OpenAI API 인증 설정 가이드
OpenAI API를 통해 GPT 모델을 활용한 텍스트 생성, 이미지 생성(gpt-image, DALL-E), 음성 변환(TTS), 비디오 생성(Sora) 등 다양한 AI 기능을 사용할 수 있습니다.
사전 준비
OpenAI 계정이 필요합니다.
API 사용을 위한 결제 정보 등록이 필요합니다 (유료).
API 키 발급 방법
1. 계정 생성
OpenAI Platform에 접속하여 계정을 생성합니다.
결제 정보를 등록합니다 (Settings → Billing).
2. API 키 생성
API Keys 페이지로 이동합니다.
Create new secret key를 클릭합니다.
키 이름을 입력하고 권한을 설정합니다.
생성된 API Key를 안전하게 저장합니다 (한 번만 표시됩니다).
3. (선택) 조직 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) |
|
주요 모델
Chat / 텍스트 생성
모델 | 설명 |
|---|---|
gpt-5.4 | 최고 성능 플래그십 모델 (1M 컨텍스트) |
gpt-5.4-pro | 전문가용 최상위 모델 |
gpt-5.4-mini | 코딩/에이전트에 최적화된 균형 모델 (400K 컨텍스트) |
gpt-5.4-nano | 가장 저렴한 GPT-5.4급 모델 |
gpt-4o / gpt-4o-mini | 이전 세대 멀티모달 모델 |
gpt-4.1 / mini / nano | 코딩/지시 따르기 특화 모델 시리즈 |
o3 / o4-mini | 추론(reasoning) 특화 모델 |
이미지 생성
모델 | 설명 |
|---|---|
gpt-image-1.5 | 최신 이미지 생성 모델 (고품질) |
gpt-image-1-mini | 경량 이미지 생성 모델 |
dall-e-3 | 텍스트 기반 이미지 생성 (레거시) |
음성 생성 (TTS)
모델 | 설명 |
|---|---|
tts-1 | 표준 TTS 모델, 빠른 응답 속도 |
tts-1-hd | 고품질 TTS 모델 |
gpt-4o-mini-tts | 최신 TTS 모델, 자연스럽고 표현력 있는 음성 |
비디오 생성
모델 | 설명 |
|---|---|
sora-2 | 속도 최적화, SNS 콘텐츠에 적합 |
sora-2-pro | 프로덕션 품질, 1080p 지원 |
시스템 증명서 사용
워크플로우에서는 시스템 증명서를 통해 별도의 OpenAI API 키 없이도 AI 노드를 사용할 수 있습니다.
시스템 증명서란?
시스템 증명서는 플랫폼에서 공유되는 API 키입니다. 사용자가 직접 API 키를 발급받지 않아도 워크플로우에서 AI 기능을 바로 사용할 수 있습니다.
동작 방식
워크플로우 노드에서 인증 정보를 선택할 때, 사용자 본인의 인증 정보가 먼저 검색됩니다.
사용자 인증 정보가 없으면 시스템 증명서로 자동 fallback됩니다.
시스템 증명서를 사용한 경우, 사용량에 따라 비용이 자동 정산됩니다.
비용 안내
시스템 증명서를 사용하면 토큰 사용량 기반으로 비용이 부과됩니다. 원가에 30% 마진이 적용됩니다.
Chat 모델 토큰 단가 (1,000 토큰당, 원가 기준)
모델 | 입력 토큰 | 출력 토큰 |
|---|---|---|
gpt-5.4 | 3.5원 | 21원 |
gpt-5.4-pro | 42원 | 252원 |
gpt-5.4-mini | 1.05원 | 6.3원 |
gpt-5.4-nano | 0.28원 | 1.75원 |
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원 |
gpt-4.1-nano | 0.14원 | 0.56원 |
o3 | 2.8원 | 11.2원 |
o4-mini | 1.54원 | 6.16원 |
이미지 모델 토큰 단가 (1,000 토큰당, 원가 기준)
모델 | 입력 토큰 | 출력 토큰 |
|---|---|---|
gpt-image-1.5 | 7원 | 44.8원 |
gpt-image-1-mini | 2.8원 | 11.2원 |
TTS 모델 단가 (1,000 토큰 근사치당, 원가 기준)
모델 | 입력 | 출력 |
|---|---|---|
tts-1 | 21원 | - |
tts-1-hd | 42원 | - |
gpt-4o-mini-tts | 0.21원 | 28원 |
비디오 모델 (초당 과금)
모델 | 720p | 1024p | 1080p |
|---|---|---|---|
sora-2 | $0.10/초 | - | - |
sora-2-pro | $0.30/초 | $0.50/초 | $0.70/초 |
최종 청구 금액 = 원가 × 1.3 (30% 마진 포함)
비용 계산 예시
gpt-5.4-mini 모델로 입력 2,000 토큰, 출력 500 토큰을 사용한 경우:
원가: (2 × 1.05) + (0.5 × 6.3) = 2.1 + 3.15 = 5.25원
최종 비용: 5.25 × 1.3 = 6.83원
비용 절약 팁
간단한 작업에는
gpt-5.4-nano를 사용하면 비용을 크게 절감할 수 있습니다.직접 OpenAI API 키를 발급받아 사용하면 시스템 증명서 마진 없이 OpenAI 원가로 이용 가능합니다.
비디오 생성은 비용이 높으므로, 테스트 시 sora-2 + 8초 + 720p 설정을 권장합니다.