API 키 설정
GPT API 키: 발급·설정·테스트
GPT API 키를 설정하기 전에 발급처를 확인하세요. 키, API URL, 모델 ID가 서로 맞아야 합니다. 아래 단계에서는 OmniaKey를 통한 연결을 설정합니다.
제공업체 공식 키
OpenAI에서 직접 발급하고 청구하는 키는 해당 제공업체의 계정 및 API 키 안내를 따르세요.
공식 키 안내 열기OmniaKey API 키
계정에서 사용할 수 있는 모델은 OmniaKey 잔액과 키 하나로 이용하세요. 키는 OmniaKey 엔드포인트에서 작동합니다.
API 키 발급받기01OmniaKey API 키 만들기
로그인한 뒤 API 키 화면을 열고 애플리케이션용 키를 만드세요. 할당량, 만료일, 모델 제한을 확인하세요. 생성 요청을 실행하기 전에 잔액을 충전하세요.
API 키 발급받기02키와 API URL 설정
자신의 터미널에서 명령을 실행하고 플레이스홀더를 자신의 키로 바꾸세요. 키는 서버나 시크릿 매니저에 보관하세요. 브라우저 코드나 공개 저장소에 절대 넣지 마세요.
export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"03인증 확인
생성 작업을 시작하지 않고 모델 목록을 요청하세요. 성공 응답은 data 배열이 포함된 JSON입니다. 이는 키 액세스를 확인할 뿐이며 모든 모델이 계정에서 활성화되어 있음을 의미하지는 않습니다.
curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"04모델의 요청 형식 사용
패밀리 페이지에서 모델을 선택하고 API ID를 복사한 뒤 해당 API 문서를 따르세요. 인증만으로는 생성 파라미터가 올바른지 확인할 수 없습니다.
클라이언트가 선택한 모델의 프로토콜을 지원해야 합니다. Chat Completions, Responses 또는 제공업체 네이티브 엔드포인트 사이를 전환하기 전에 모델 문서를 확인하세요.
생성 요청 예시(유료)
이 요청은 계정 잔액을 사용합니다. 먼저 선택한 모델의 가격을 확인하세요. 예시는 문서화된 요청 형식을 따르며, 계정에 해당 모델 액세스 권한이 있어야 합니다.
curl --fail-with-body 'https://api.omniakey.com/v1/responses' \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"input": "Explain what an API key does in one sentence."
}'연결에 실패하는 경우
- 401: 키가 완전하고 활성 상태이며 호출하는 API URL용으로 발급되었는지 확인하세요.
- 403: 키의 모델 제한과 계정에서 사용할 수 있는 권한을 확인하세요.
- 404 또는 JSON 대신 HTML이 반환되는 경우: API 호스트와 버전 접두사를 확인하세요. 웹사이트 주소가 아니라 api.omniakey.com을 사용하세요.
- 429: 동시 실행 수를 줄이고 응답의 재시도 안내를 따르세요. 새로운 멱등 키로 생성 작업을 계속 제출하지 마세요.