AI API 키 테스트기: 30초 만에 키 확인

웹 페이지가 아닌 로컬에서 테스트해야 하는 이유

AI API 키 테스트기를 검색하면 키를 붙여넣고 버튼을 누르는 많은 페이지가 나옵니다. 이를 피하세요. 키는 당신의 돈을 쓰는 비밀번호이므로 해당 페이지가 이를 어떻게 처리하는지 알 수 없습니다. 아래 테스트는 반 분 정도 걸리며 자체 머신에서 실행되고 키를 원하는 API에만 전송합니다.

세 가지가 필요합니다: 키, base URL https://api.getaiapikey.com/v1, 모델 ID uncensored. 키를 환경 변수에 넣어서 셸 히스토리에 남거나 당신이 커밋할 수 있는 파일에 남지 않게 하세요.

Copyexport API_KEY="paste-your-key-here"

키는 API 키 페이지에서 가져옵니다. 아직 키가 없다면, 신규 사용자는 가입 후 한 번의 클릭로 $0.50의 체험 크레딧을 청구할 수 있으며, 이는 이 문서의 모든 테스트를 여러 번 수행하기에 충분합니다.

테스트 1: curl로 모델 목록 나열

가장 저렴한 테스트는 모델 목록입니다. 유효한 키와 올바른 base URL이 필요하며 텍스트를 생성하지 않습니다.

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

-i 플래그는 응답 헤더를 출력합니다. 정상적인 응답은 HTTP/2 200로 시작하며, 모델 ID uncensored를 포함하는 JSON 본문이 이어집니다. 대신 인증 오류(보통 상태 401)가 발생하면 키가 잘못되었거나, 끝에 공백이 포함되어 복사되었거나, 헤더에 Bearer 단어가 빠져 있습니다. 404는 URL이 잘못되었음을 의미하며, 가장 흔한 원인은 /v1이 누락되었거나 중복된 경우입니다.

확인 2: 실제 응답 생성 실행하기

키는 유효하지만 실제 요청에서는 실패할 수 있습니다. 예를 들어 잔액이 비어있는 경우입니다. 따라서 작은 채팅 호출을 보내고 출력을 제한하여 비용을 거의 0으로 유지하세요:

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

본문보다 먼저 헤더를 읽어보세요. X-Request-Id는 호출을 식별하며, 이는 지원팀이 요청하는 정보입니다. X-Balance-USD은 남은 크레딧 금액을 보여줍니다. X-RateLimit-Limit-Requests와 X-RateLimit-Limit-Concurrency은 키의 제한을 드러냅니다: 전체 키의 경우 300과 8, 체험 키의 경우 60과 2입니다. 따라서 이 한 번의 호출은 인증, 모델, 잔액 및 키 유형을 모두 확인합니다.

테스트 비용은 무시할 수준입니다. 약 10 토큰의 프롬프트와 5 토큰의 응답은 10 x $0.15 / 1M + 5 x $0.50 / 1M로 약 $0.000004가 듭니다. 실패하거나 거부된 요청에는 요금이 전혀 부과되지 않습니다.

확인 3: Python으로 동일한 테스트

실제 코드에서 Python을 사용한다면, 코드가 실행되는 방식으로 테스트하세요. 이 스크립트는 공식 openai 패키지를 사용하므로, 여기서 통과하면 애플리케이션 설정도 작동함을 의미합니다:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

with_raw_response 래퍼는 헤더에 접근할 수 있게 해주고, parse()는 일반적인 응답 객체를 반환합니다. Python 설정 자체는 import가 실패하는 경우 Python에 LLM 클라이언트 설치하기를 참조하세요.

completion 없이 잔액 확인

텍스트 생성 없이 잔액을 읽으려면 잔액 엔드포인트 중 하나를 호출하세요. OpenAI 스타일의 것과 짧은 것이 있습니다:

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

이미 OpenAI 크레딧 부여 형식을 기대하는 도구는 두 번째 경로를 그대로 사용할 수 있습니다. 모니터링 스크립트에 이런 호출을 추가하면 프로덕션 봇이 고갈되기 전에 경고 메시지를 받을 수 있습니다. 충전은 $20부터 시작하며 크레딧은 만료되지 않으므로 여유 있는 잔액을 유지해도 패널티가 없습니다. 금액과 보너스는 가격 책정 페이지에서 확인할 수 있습니다.

테스트를 헬스 체크로 전환

키가 작동하면 해당 테스트를 계속 유지하세요. 일정대로 실행되는 작은 스크립트는 사용자보다 먼저 잘못된 배포, 만료된 시크릿 또는 낮은 잔액에 대해 알려줍니다. 여기 내장 fetch을 사용하는 Node 버전의 예시입니다(Node 18 이상):

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

호출이 실패하거나 잔액이 $5 미만으로 떨어지면 스크립트는 0이 아닌 코드로 종료되므로 cron 작업이나 CI 단계에서 알림을 보낼 수 있습니다. 임계값은 자체 소모율에 따라 선택하세요: 하루 $2라면 $5는 2일보다 약간 더 긴 경고 시간을 제공합니다.

통과한 테스트가 증명하지 못하는 것

초록색 체크 표시는 저부하 상태에서 인증, 라우팅, 모델이 현재 작동함을 보여줍니다. 20명의 사용자가 동시에 사용할 때 애플리케이션이 어떻게 동작하는지는 보여주지 않습니다. 이를 위해 제한을 기억하세요: 전체 권한을 가진 키는 동시에 8개의 요청을 처리할 수 있으며, 스트리밍 요청은 스트림이 끝날 때까지 슬롯을 유지합니다. 출시 전 병렬 호출 제한을 두고 자체 코드를 부하 테스트하세요.

실패 읽기

표시되는 내용	가장 가능성 높은 원인	해야 할 일
인증 오류, 보통 401	잘못된 키, 추가 공백, Bearer 접두사 없음	키 다시 복사, 헤더 문자열 확인
JSON 대신 404 또는 HTML	잘못된 base URL	정확히 https://api.getaiapikey.com/v1를 사용하세요
모델을 찾을 수 없음	요청의 다른 모델 ID	model을 uncensored로 설정하세요.
429 오류 발생 이유: rate_limited 또는 concurrency	분당 또는 동시 요청 수 초과	대기 후 지연 시간 후 재시도
429와 함께 Retry-After: 5	일시적 과부하	5초 대기 후 재시도
연결 또는 타임아웃 오류	네트워크, 프록시 또는 방화벽	다른 네트워크에서 테스트, 프록시 변수 확인

8 MB를 초과하는 요청은 거부되므로, 큰 호출만 실패하는 경우 본문 크기를 확인하세요. 문서에는 모든 오류 코드와 헤더가 나열되어 있습니다.

키 처리를 위한 좋은 습관

• 키를 환경 변수나 시크릿 저장소에 보관하고, 클라이언트 측 코드, 공개 저장소 또는 스크린샷에 두지 마세요.
• 가능한 경우 애플리케이션마다 하나의 키를 사용하세요. 그러면 유출 시 추적 및 교체가 쉽습니다.
• 키가 유출되었을 가능성이 있으면 교체한 후 잔액을 확인하여 예상치 못한 지출이 있는지 확인하세요.
• 시험용 키를 여러 프로그램 간에 공유하지 마세요. 동시 요청 2개로도 제한에 빠르게 도달합니다.

가입하기 전에 무료 옵션이 있는지 확인하고 싶다면, 무료 LLM API 키에 대한 기사를 참조하세요. 그렇지 않다면, 위의 세 가지 확인 사항이 키를 테스트하는 데 필요한 모든 것입니다.

더 많은 가이드

• AI API 키 가격 책정: 하나의 키가 실제로 얼마의 비용이 들까요
• AI API 체크리스트