OpenAI API key 발급부터 결제 설정·첫 호출까지

1. 로그인 후 사용할 프로젝트 선택하기

platform.openai.com에 접속해 계정을 만들거나 로그인합니다. 화면에 나오는 초기 설정 안내를 완료합니다. OpenAI 빠른 시작 가이드에서도 API 키 대시보드로 바로 이동할 수 있습니다.

계정을 사원증, **조직(organization)**을 회사, **프로젝트(project)**를 특정 앱에 배정된 방이라고 생각하면 이해하기 쉽습니다. API 키는 소프트웨어가 그 방에 들어갈 때 제시하는 인증 정보입니다.

조직 전환 메뉴에서 사용할 조직을 선택합니다. 기존 프로젝트를 선택하거나, 조직 소유자라면 프로젝트 메뉴의 Create project를 눌러 필요한 정보를 입력합니다. website-test처럼 이름만 봐도 용도를 알 수 있게 정하는 것이 좋습니다. 자세한 설정 방법은 OpenAI 프로젝트 가이드에 나와 있습니다.

회사 업무라면 소유자에게 해당 프로젝트에 추가해 달라고 요청합니다. 개인 결제 계정에 이미 로그인되어 있다는 이유만으로 그 계정에서 고객사 연동 작업을 시작하지 않습니다.

2. 프로젝트에서 OpenAI API key 발급하기

조직 설정에서 프로젝트를 선택한 뒤 API Keys를 열고 + Create new secret key를 누릅니다. 선택한 프로젝트에 연결된 키가 생성됩니다. 프로젝트 키 생성 안내.

직접 처음 테스트할 때는 사용자 소유의 프로젝트 키를 사용합니다. 이름을 입력하는 화면이 나오면 local-test처럼 알아보기 쉽게 지정합니다. 권한은 Restricted를 선택하고 앱에 필요한 작업만 허용합니다. 기본값인 All은 전체 접근 권한을 부여하며, Read Only는 읽기 작업만 허용합니다. API 키 권한 안내. 아래 테스트를 실행하려면 Responses 생성 권한을 허용해야 합니다. OpenAI에서 이 권한의 이름은 api.responses.write입니다. 응답 생성 권한 안내.

비밀 키가 표시되면 즉시 복사해 안전한 저장소에 보관합니다. OpenAI는 생성 시점에만 키의 전체 값을 보여 줍니다. 분실하면 새 키를 만들어야 하며, 원래 값을 다시 확인할 수는 없습니다. API 키 확인 및 관리 안내.

만료일을 설정하고 키를 교체할 담당자도 기록합니다. 조직 정책에 따라 만료일 설정이 필수이거나 생성할 수 있는 키 유형이 제한될 수 있습니다. 필요한 옵션이 보이지 않으면 관리자에게 정책을 확인합니다. OpenAI 운영 환경 가이드. 테스트를 실제 서비스로 전환하기 전에 API 키 만료 및 교체 계획을 참고합니다.

서비스 계정 키는 언제 사용하는 것이 좋을까요?

배포된 앱이나 팀에서 정기적으로 실행하는 워크플로에는 서비스 계정을 권장합니다. 사람이 아니라 소프트웨어에 부여하는 계정입니다. 조직 또는 프로젝트 소유자가 해당 프로젝트의 Members → + Service account에서 생성합니다. 생성된 키는 즉시 저장합니다. 서비스 계정은 Default 프로젝트에 직접 추가할 수 없으므로 전용 프로젝트를 사용해야 합니다. 서비스 계정 설정 안내.

생성 후 프로젝트의 API Keys 설정에서 접근 권한을 검토합니다. 서비스 계정 생성 창에는 사용자 소유 키와 동일한 권한 설정 옵션이 제공되지 않습니다. 권한 설정의 차이. 이렇게 관리하면 팀원이 바뀌어도 앱 인증 정보의 관리 책임이 명확하게 유지됩니다.

3. API 결제 등록과 지출 한도 설정하기

ChatGPT 결제와 API 결제는 별개입니다. ChatGPT를 유료로 사용하고 있어도 API 결제 설정은 따로 해야 합니다. 사용할 조직의 API 결제 개요를 엽니다. 조직 소유자가 해당 조직의 결제를 관리할 수 있습니다. OpenAI 결제 안내.

신규 API 계정은 선불 결제를 사용합니다. Add payment details를 선택해 결제 정보를 등록하고, 처음 구매할 크레딧 금액을 정한 뒤 확인합니다. 결제 전에 Use auto-reload 설정을 살펴봅니다. OpenAI에 따르면 이 옵션은 기본적으로 켜져 있습니다. 수동 충전 방식으로 테스트하려면 끄고, 자동 충전을 사용하려면 충전 기준 잔액과 월간 자동 충전 한도를 의도에 맞게 설정합니다. 구매한 크레딧이 반영되기까지 몇 분이 걸릴 수 있습니다. 선불 결제 설정 안내.

현재 모델별 요금은 OpenAI 가격 페이지에서 확인합니다. 앱 예산을 잡는 데 필요한 맥락은 이 사이트의 OpenAI API 가격 가이드를 참고합니다.

한도에 도달하면 요청을 중단하려면 어떻게 설정할까요?

Project settings → Limits → Spend → Edit spend limit에서 Monthly spend limit에 월간 지출 한도를 입력하고, Enforce a hard limit를 켠 뒤 저장합니다. 이 설정을 변경하려면 해당 프로젝트의 설정 관리 권한이 필요합니다. 서비스가 중단되기 전에 담당자가 대응할 수 있도록 한도보다 낮은 금액에 지출 알림도 설정합니다. 지출 한도 설정 안내.

강제 한도 적용에는 지연이 있어 기록된 지출이 설정 금액을 조금 초과할 수 있습니다. 조직 단위의 강제 한도는 그 조직에 속한 프로젝트의 지출을 합산해 적용합니다. 선불 크레딧도 차단이 지연되는 동안 잔액을 초과해 사용될 수 있으며, 수동 구매는 자동 충전 한도에 포함되지 않습니다. 강제 한도의 작동 방식, 선불 결제의 작동 방식.

운영 환경에 적용하려면 OpenAI API 강제 지출 한도 가이드를 읽고, 한도 때문에 서비스가 중단될 때 누가 상향 조정할 수 있는지도 정합니다.

4. 앱에서 안전하게 사용할 수 있도록 키 보관하기

키는 인증 정보를 보관하도록 설계된 시크릿 관리 서비스에 저장하거나, OPENAI_API_KEY라는 환경 변수로 서버에 전달합니다. 환경 변수는 실행 중인 프로그램이 읽을 수 있는 이름이 붙은 설정값입니다. 이를 사용하면 소스 코드에 비밀 값을 직접 넣지 않아도 됩니다. 운영 환경의 키 보관 가이드.

일반 API 비밀 키를 웹사이트의 JavaScript, 모바일 앱, 코드 저장소, 스크린샷, 고객 지원 메시지에 넣지 않습니다. 브라우저와 모바일 앱의 코드는 사용자 기기에 전달됩니다. 비밀 키는 서버에 두고 서버에서 요청을 보내야 합니다. 한 사람의 키를 돌려 쓰는 대신 팀원마다 별도의 접근 권한을 부여합니다. API 키 보안 수칙.

도구에서 키를 붙여 넣으라고 한다면: 해당 업체에 인증 정보를 맡겨도 괜찮다고 판단한 뒤, 공식 안내에 명시된 인증 정보 입력란에만 입력합니다. 이 연동을 위한 전용 프로젝트와 제한된 권한의 키를 만들고, 지출 한도와 관리 책임자를 정하는 것을 권장합니다. 연결 문제를 진단하겠다고 일반 텍스트 입력란이나 채팅 메시지, 출처가 불분명한 ‘키 확인 도구’에 키를 넣어서는 안 됩니다. 업체에 어떤 권한이 필요한지, 비밀 키를 어디에 보관하는지 확인합니다.

5. OpenAI API 사용법: curl로 첫 요청 테스트하기

컴퓨터의 Bash에서 아래 명령을 실행합니다. curl은 웹 요청을 보내는 명령줄 도구입니다. 처음 몇 줄은 비밀 키를 화면에 표시하지 않고 입력받으며, 직접 입력하는 명령문에도 키 값이 남지 않게 합니다. 환경 변수는 해당 셸 세션이 유지되는 동안 유효합니다.

read -r -s -p "OpenAI API key: " OPENAI_API_KEY
printf '\n'
export OPENAI_API_KEY

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-6-astra",
    "input": "Reply with a short greeting."
  }'

이 코드는 OpenAI의 텍스트 생성 예제에 나오는 요청 구조와 모델을 사용합니다. Responses API는 입력을 받아 모델의 출력을 반환하는 엔드포인트입니다. 인증 헤더에는 비밀 키를 담고, JSON 본문에서는 사용할 모델과 수행할 지시를 지정합니다. 실제 API 사용 요청이므로 결제 설정과 모델 접근 권한이 준비되어 있어야 합니다.

요청이 성공하면 응답의 output 배열에 output_text 콘텐츠를 담은 메시지가 포함됩니다. 여기에서 인사말을 확인합니다. 텍스트가 항상 배열의 첫 번째 항목에 있다고 가정해서는 안 됩니다. error 객체가 반환되면 그 메시지와 코드를 아래 내용과 함께 확인합니다. 응답 구조 안내.

테스트를 마친 뒤 키가 더 이상 필요하지 않으면 unset OPENAI_API_KEY를 실행해 현재 셸의 변수를 지웁니다. 배포할 때는 터미널에서 키를 다시 입력하는 대신 호스팅 환경에 비밀 값을 설정합니다.

API 키가 작동하지 않을 때 무엇부터 확인할까요?

새 키를 만들기 전에 오류 내용을 먼저 읽습니다. 키 자체와 관계없는 원인으로 실패하는 경우도 있습니다.

429 응답은 요청 속도 제한뿐 아니라 지출 한도나 크레딧 문제를 뜻할 수도 있습니다. 재시도를 반복해도 크레딧이 충전되거나 설정된 한도가 바뀌지는 않습니다. OpenAI 오류 코드, 키 권한 안내.

API 키가 유출되었다면 즉시 폐기하기

공개 저장소, 스크린샷, 메시지에 붙여 넣은 비밀 키는 노출된 것으로 간주합니다. 화면에 보이는 값을 삭제해도 누군가 이미 확보한 복사본까지 무효화되지는 않습니다.

1. 노출된 키를 폐기합니다. 해당 프로젝트의 API 키 페이지를 열어 키를 삭제합니다. 이 키를 사용하는 앱은 새 키로 교체할 때까지 작동이 중단될 수 있습니다. 키 삭제 안내.
2. 새 키를 만들고 영향을 받는 앱에 반영합니다. 새 키로 테스트한 뒤 배포된 프로세스가 그 키를 사용하는지 확인합니다.
3. 사용 내역과 결제를 검토합니다. 예상하지 못한 요청을 조사하고, 오용이 의심되면 OpenAI Support에 문의합니다. OpenAI는 유출이 의심될 때 즉시 키를 교체하도록 권장합니다. 유출 대응 안내.
4. 노출 원인을 해결합니다. 코드와 로그에서 비밀 값을 제거하고, 유출을 일으킨 보관 또는 공유 방식을 바로잡습니다. 계정 자체가 침해되었을 가능성이 있다면 비밀번호를 변경하고 다른 세션을 로그아웃시킨 뒤 무단 활동을 신고합니다. 계정 복구 절차.

이 설정을 활용할 수 있는 다섯 가지 업무

이 설정의 장점은 연동의 관리 책임자와 예산이 명확해진다는 데 있습니다. 팀에서 실제로 활용할 수 있는 업무를 당장 도움이 되는 순서로 정리했습니다.

키가 작동한다는 것은 요청을 실행할 수 있다는 뜻입니다. 프롬프트가 신뢰할 만한지, 업체가 인증 정보를 안전하게 다루는지, 자동화에 고객 데이터 접근 권한을 줘도 되는지까지 입증하지는 않습니다. 이는 여전히 제품과 운영 측면에서 판단할 문제입니다.

이 설정 과정에서 만들 만한 두 가지 기능

가장 유망한 기회는 고객에게 OpenAI 키 입력을 요구하는 소프트웨어 안에 연결 도우미를 넣는 것입니다. DataForSEO 추정치에 따르면 “how to get openai api key”의 미국 월간 검색량은 1,000회입니다. 이는 설정 과정에 어려움이 있다는 근거이지, 유료 고객 수를 예측하는 수치는 아닙니다. 도구 업체는 프로젝트 설정 체크리스트, 안전한 인증 정보 입력란, 명확한 테스트 버튼, 이해하기 쉬운 결과 화면을 구매하거나 직접 만들 수 있습니다. 최소 버전은 해당 연결이 필요한 제품 안에 들어가야 합니다. 다만 업체가 직접 만들 수도 있으므로, 고객 지원 부담을 줄이고 안내를 최신 상태로 유지하는 데서 가치를 제공해야 합니다.

오류 해설 기능은 고객 지원에 유용하지만, 독립 제품으로서의 수요는 더 약합니다. 같은 조사에서 “openai api key not working”의 미국 월간 검색량은 10회에 그칩니다. 자동화 도구 업체나 구축 에이전시는 민감한 정보를 가린 오류 코드와 메시지를 입력받아, 인증 정보·크레딧·권한·요청 속도 중 무엇을 해결해야 하는지 설명하는 양식을 제공할 수 있습니다. 첫 버전에 필요한 것은 지속적으로 관리하는 오류별 대응표이며, 사용자의 키를 보관할 필요는 없습니다. 측정된 검색량이 적고 이미 많은 도구가 이러한 오류를 표시한다는 점은 한계입니다. 별도 유료 제품으로 출시하기보다는 초기 설정 과정에 붙이는 편을 권장합니다.

이 수치는 이 가이드를 위해 확인한 DataForSEO 키워드 개요의 미국 영어 검색량 추정치입니다. 고유 사용자 수나 구매 의도가 아니라 검색 횟수를 나타냅니다.

월요일에 바로 실행할 일: 연동할 대상을 하나 정하고, 담당자를 지정하고, 프로젝트를 만들고, 지출 제어를 설정한 뒤, 비밀 값을 제거한 테스트 성공 결과를 저장합니다. 다음 유지보수 담당자에게 넘길 수 있는 유용한 인수인계 자료가 됩니다.

이 연동을 운영 환경으로 옮기는 데 도움이 필요하다면, AI 운영 시스템에서 관련 운영 업무를 확인할 수 있습니다.