KO ▾

curl과 Python으로 AI API 키 테스트하는 방법

성공적인 API 키 테스트를 나타내는 세 개의 녹색 표시등이 있는 자물쇠에 키를 꽂는 이미지

아무것도 빌드하지 않고 AI API 키 접근 권한을 테스트하는 방법: 세 번의 호출, 약 2분이면 키가 유효한지, 자금이 충전되었는지, 텍스트 생성이 허용되는지 알 수 있습니다.

업데이트

주요 포인트

  • 먼저 GET /v1/models를 호출하세요: 이 호출은 크레딧을 쓰지 않고 키가 승인되었음을 증명합니다.
  • 모델 uncensored로 짧은 채팅 요청을 전송하여 생성이 정상적으로 작동하는지 확인합니다.
  • X-Balance-USD 헤더를 읽거나 GET /v1/balance를 호출하여 남은 잔액을 확인합니다.
  • 401은 키를, 402는 잔액을, 429는 요청 속도를 나타냅니다.

세 가지 호출 테스트

AI API 키를 제대로 테스트하려면 세 가지 사실을 증명해야 합니다: 서버가 키를 받아들이는지, 키에 크레딧이 있는지, 그리고 실제 생성 응답이 반환되는지입니다. 각 확인 사항당 한 번의 호출로 진단을 단순하게 유지하세요. 실패할 경우 어떤 계층에 문제가 있는지 알 수 있습니다.

  1. 모델 목록. 키를 인증하며 비용이 들지 않습니다.
  2. 채팅 완결. 모델이 응답하고 요청 형식이 올바른지 확인합니다.
  3. 잔액. 테스트 후 남은 잔액을 확인합니다.

아래의 모든 내용은 base URL https://api.aiapisource.com/v1과 모델 ID uncensored을 사용합니다. 키를 환경 변수에 저장하여 셸 히스토리나 저장소에 남지 않도록 하세요.

export AIAPI_KEY="paste-your-key-here"

아직 키가 없다면 API 키 페이지에서 생성 방법을 확인할 수 있습니다. 새 계정은 클릭 한 번으로 $0.50 체험 크레딧을 청구할 수 있으며, 이 문서의 모든 테스트에 충분 이상입니다.

단계 1: curl로 모델 목록 조회

가장 저렴한 확인 방법은 읽기 전용 요청입니다. GET /v1/models은 모델 목록을 반환하며 유효한 키가 필요하므로, 성공적인 응답은 인증이 완료되었음을 증명합니다.

curl -s https://api.aiapisource.com/v1/models \
  -H "Authorization: Bearer $AIAPI_KEY"

정상적인 응답은 uncensored를 포함하는 data 배열을 가진 JSON입니다. HTML 페이지, 연결 오류 또는 빈 응답이 표시되면 문제는 키가 아닌 URL에 있습니다. /v1 접미사가 유지되었는지, 변수의 키 뒤에 공백이 없는지 확인하세요.

curl 명령어에 -i를 추가하여 응답 헤더를 확인하세요. API는 모든 호출에 X-Request-Id를 전송합니다. 지원에 문의할 경우 해당 값을 보관하세요. 이는 정확한 요청을 식별하는 데 사용됩니다.

단계 2: 채팅 요청 전송

이제 생성을 확인합니다. 프롬프트를 작게 유지하고 출력을 제한하여 테스트 비용이 1센트 미만으로 들게 합니다.

curl -s https://api.aiapisource.com/v1/chat/completions \
  -H "Authorization: Bearer $AIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the single word: ready"}],
    "max_tokens": 10
  }'

choices[0].message.content와 prompt_tokens, completion_tokens를 포함하는 usage 객체를 확인하세요. 입력 토큰 약 20개와 출력 토큰 5개로 이루어진 요청은 20 / 1,000,000 x $0.15 + 5 / 1,000,000 x $0.50인 약 $0.0000055가 듭니다. 이러한 요청을 백 개 정도 실행해도 1센트 미만으로 충분합니다.

동일한 엔드포인트는 스트리밍에도 작동합니다: "stream": true를 추가하면 토큰이 서버 전송 이벤트로 도착합니다. 기본 호출이 작동한 후 별도로 테스트하세요.

단계 3: Python으로 동일한 테스트

실제 코드에서 OpenAI SDK를 사용하는 경우 SDK를 통해 테스트하세요. Base URL이 잘못된 인수로 전달되는 등 curl로는 잡지 못하는 문제를 감지합니다.

import os
from openai import OpenAI

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

print([m.id for m in client.models.list().data])

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)

첫 번째 출력에는 uncensored가 포함된 목록이 표시되어야 합니다. 두 번째 출력에는 모델의 응답이 표시됩니다. SDK 설정에 대한 더 자세한 가이드는 이 사이트의 OpenAI API Python 가이드를 참조하세요.

키를 내보낸 동일한 셸에서 Python 버전을 실행하세요. AIAPI_KEY에서 KeyError가 발생하면 해당 세션에서 변수가 설정되지 않았다는 의미이며, 이는 네트워크에 도달하기 전에 테스트가 실패하는 가장 흔한 이유입니다.

Node.js도 동일한 방식으로 작동합니다: OpenAI 클라이언트 생성자에 baseURL: "https://api.aiapisource.com/v1"과 키를 전달하세요.

잔액 확인

키는 유효하지만 사용할 잔액이 없을 수 있습니다. 잔액을 확인하는 두 가지 방법이 있습니다:

curl -s https://api.aiapisource.com/v1/balance \
  -H "Authorization: Bearer $AIAPI_KEY"

# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $AIAPI_KEY"

모든 응답에는 X-Balance-USD 헤더가 포함되므로, 2단계의 채팅 호출을 -i와 함께 실행했다면 이미 남은 크레딧을 알 수 있습니다. Python에서는 OpenAI SDK가 client.chat.completions.with_raw_response.create(...)를 통해 이를 노출하며, 여기서 response.headers["X-Balance-USD"]을 읽습니다.

실패하거나 거부된 요청에는 요금이 부과되지 않으므로 오류가 발생해도 크레딧이 소모되지 않습니다. 선불 크레딧은 만료되지 않으므로 사용하지 않은 잔액은 다음 주에도 그대로 존재합니다.

오류 코드 읽기

테스트가 실패하면 HTTP 상태 코드로 원인을 빠르게 좁힐 수 있습니다.

상태일반적인 의미대응 방법
401키가 누락되었거나 오타가 있거나 무효화되었습니다Authorization: Bearer 헤더를 확인하고 키를 다시 복사하며, 숨겨진 공백이나 따옴표가 있는지 확인하세요
402요청을 지불할 잔액이 없음잔액을 확인한 후 가격 페이지에서 충전하세요
404잘못된 경로 또는 잘못된 모델 ID/v1/chat/completions과 모델 uncensored을 사용하세요
429속도 또는 동시성 제한, 또는 일시적 과부하대기 후 다시 시도; 아래 참조

429는 오류 상태를 포함합니다. rate_limited는 분당 요청 수가 많음을 의미하고, concurrency은 동시에 요청이 많음을 의미합니다. 전체 키는 분당 300개 요청과 8개의 동시 요청을 허용하며, 체험 키는 분당 60개와 동시에 2개를 허용합니다. 일시적 과부하 시 API는 429를 Retry-After: 5와 함께 반환하므로 5초 기다린 후 요청을 다시 보냅니다. 스트리밍 요청은 스트리밍이 완료될 때까지 동시 요청 슬롯을 유지하므로, 이는 체험 키가 병렬 테스트 중 제한에 도달하는 흔한 이유입니다.

상태 코드 401, 402, 404는 일반적인 API 관례를 따르므로, 이 표를 첫 번째 추측으로 간주하고 정확한 메시지는 JSON 오류 본문에서 읽어보세요.

재사용 가능한 스모크 테스트 스크립트

수동 테스트가 통과하면 키를 회전하거나 환경을 변경한 후 실행할 수 있는 스크립트를 유지하세요.

import os, sys
import requests

BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}

m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)

c = requests.post(
    BASE + "/chat/completions",
    headers=H,
    json={"model": "uncensored",
          "messages": [{"role": "user", "content": "ping"}],
          "max_tokens": 5},
    timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)

종료 코드는 배포 확인에 쉽게 적용할 수 있습니다. 이 최소값을 넘어선 매개변수에 대해서는 API 문서에서 엔드포인트가 허용하는 모든 내용을 확인할 수 있습니다.

질문과 답변

API 키 테스트에 비용이 발생하나요?

모델 목록 호출은 무료입니다. 낮은 max_tokens을 사용한 짧은 채팅 요청은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50으로 몇 백만 분의 1달러 비용이 듭니다. 실패한 요청에는 요금이 청구되지 않습니다.

카드 없이 키를 테스트하려면 어떻게 하나요?

가입 후 API 키 페이지에서 $0.50 체험 크레딧을 청구하세요. 카드가 필요 없으며 7일 동안 유효하고, 사람당 하나만 청구할 수 있습니다.

유효한 키가 즉시 429 오류를 반환하는 이유는 무엇인가요?

동시성 제한이나 분당 요청 제한에 도달했을 가능성이 높습니다. 체험 키는 동시 2개, 분당 60개의 요청을 허용하며, 일반 키는 동시 8개, 분당 300개의 요청을 허용합니다. 오류 코드를 확인한 후 요청 속도를 줄이거나 몇 초 후 다시 시도하세요.

curl 대신 Postman이나 앱에서 키를 테스트할 수 있나요?

네. 모든 OpenAI 호환 클라이언트가 작동합니다: base URL을 https://api.aiapisource.com/v1로 설정하고 키를 Bearer 토큰으로 붙인 후 uncensored 모델을 사용하세요.

키를 얻으려면 양식 하나만 작성하면 됩니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기