API Key가 유효하지 않은 이유는?

일반적인 오류

다음과 같은 오류가 표시되는 경우:

{
  "error": {
    "message": "Incorrect API key provided: sk-QqHvK***...",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

이는 대개 API Key 자체의 문제가 아니라 Base URL 설정 오류입니다.

가장 흔한 실수: GravitexAI의 Key를 사용하지만 요청 URL이 여전히 OpenAI의 https://api.openai.com을 가리키는 경우

Base URL이란?

Base URL은 API 요청의 대상 서버 주소입니다. 제공업체마다 Base URL이 다릅니다.

Base URL과 API Key는 일치해야 합니다

제공업체	Base URL	API Key 형식	일치 여부
GravitexAI	https://api.gravitex.ai	sk-xxxx…	✅ 올바름
OpenAI Official	https://api.openai.com	sk-xxxx…	✅ 올바름
❌ GravitexAI Key	https://api.openai.com	sk-xxxx…	❌ 잘못됨
❌ OpenAI Key	https://api.gravitex.ai	sk-xxxx…	❌ 잘못됨

핵심 원칙: API Key에 맞는 제공업체의 Base URL을 사용하세요

올바른 구성

방법 1: Base URL 수정 (권장)

Python
Node.js
cURL

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-gravitex-key",
    base_url="https://api.gravitex.ai/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}]
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-gravitex-key',
  baseURL: 'https://api.gravitex.ai/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello' }]
});

curl https://api.gravitex.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-gravitex-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

방법 2: 환경 변수

Linux/macOS
Windows PowerShell
Windows CMD

export OPENAI_API_KEY="sk-your-gravitex-key"
export OPENAI_BASE_URL="https://api.gravitex.ai/v1"

$env:OPENAI_API_KEY="sk-your-gravitex-key"
$env:OPENAI_BASE_URL="https://api.gravitex.ai/v1"

set OPENAI_API_KEY=sk-your-gravitex-key
set OPENAI_BASE_URL=https://api.gravitex.ai/v1

지원되는 URL 형식

형식	URL	사용 사례
/v1 포함 (권장)	`https://api.gravitex.ai/v1`	대부분의 라이브러리
후행 슬래시 포함	`https://api.gravitex.ai/v1/`	일부 프레임워크
전체 경로	`https://api.gravitex.ai/v1/chat/completions`	cURL 요청

문제 해결

Base URL을 변경했는데도 여전히 오류가 발생합니다

가능한 원인:

여러 구성이 존재: 설정 파일, 환경 변수, 코드 초기화를 확인하세요
프록시 또는 미들웨어: 일부 도구가 요청을 리디렉션할 수 있습니다
캐시 문제: 프로그램을 재시작하거나 캐시를 삭제하세요
오타: URL 철자를 확인하세요

Key가 유효한지 어떻게 확인하나요?

GravitexAI 콘솔에서 확인:

GravitexAI에 로그인
“Tokens” 페이지로 이동
Key 상태가 “Enabled”인지 확인
계정 잔액이 충분한지 확인

서드파티 도구는 어떻게 구성하나요?

대부분의 도구에 “Custom API” 옵션이 있습니다:

API URL / Base URL: https://api.gravitex.ai/v1
API Key: GravitexAI 콘솔에서 복사
모델 이름: 모델 목록 참조

잘못된 구성 vs 올바른 구성 예시

❌ 잘못된 구성

client = OpenAI(
    api_key="sk-gravitex-key",
    base_url="https://api.openai.com/v1"
    # ❌ OpenAI URL 사용
)

결과: OpenAI 서버가 GravitexAI의 Key를 거부합니다

✅ 올바른 구성

client = OpenAI(
    api_key="sk-gravitex-key",
    base_url="https://api.gravitex.ai/v1"
    # ✅ GravitexAI URL 사용
)

결과: 요청이 GravitexAI로 성공적으로 전송됩니다

빠른 테스트

cURL로 구성을 확인하세요:

curl https://api.gravitex.ai/v1/models \
  -H "Authorization: Bearer sk-your-gravitex-key"

예상 결과: 사용 가능한 모델 목록 반환

{
  "data": [
    {
      "id": "gpt-4o",
      "object": "model"
    }
  ]
}

오류가 발생하면 다음을 확인하세요:

API Key가 올바르게 복사되었는지 (불필요한 공백 없음)
네트워크 연결이 정상인지
계정 잔액이 충분한지

기억하세요: Key와 URL을 일치시키세요. GravitexAI Key는 https://api.gravitex.ai/v1을 사용합니다

​일반적인 오류

​Base URL이란?

​Base URL과 API Key는 일치해야 합니다

​올바른 구성

​방법 1: Base URL 수정 (권장)

​방법 2: 환경 변수

​지원되는 URL 형식

​문제 해결

​잘못된 구성 vs 올바른 구성 예시

​❌ 잘못된 구성

​✅ 올바른 구성

​빠른 테스트

일반적인 오류

Base URL이란?

Base URL과 API Key는 일치해야 합니다

올바른 구성

방법 1: Base URL 수정 (권장)

방법 2: 환경 변수

지원되는 URL 형식

문제 해결

잘못된 구성 vs 올바른 구성 예시

❌ 잘못된 구성

✅ 올바른 구성

빠른 테스트