시작하기인증

인증

GET /v1/models 외의 모든 엔드포인트에는 API 키가 필요합니다. 다음 두 헤더 중 하나에 담아 보내세요. 두 헤더 모두 모든 엔드포인트에서 동작하므로 클라이언트가 보내는 방식을 그대로 쓰면 됩니다.

  • Authorization: Bearer $YOUR_KEY: OpenAI SDK와 대부분의 도구가 보내는 헤더입니다.
  • x-api-key: $YOUR_KEY: Anthropic SDK가 보내는 헤더입니다.

자리 표시자: $API_BASE는 https://api.abliteratedllm.dev/v1, $API_ORIGIN은 https://api.abliteratedllm.dev, $YOUR_KEY는 발급받은 API 키입니다.

bash
# OpenAI style
curl $API_BASE/balance -H "Authorization: Bearer $YOUR_KEY"

# Anthropic style
curl $API_BASE/balance -H "x-api-key: $YOUR_KEY"

API 키

키 만들기, 이름 변경, 편집, 폐기는 API 키 페이지에서 할 수 있습니다. 이 페이지에는 각 키를 마지막으로 사용한 시각(몇 분 단위 정확도)과 사용 금액도 표시됩니다.

  • 키는 sk- 뒤에 영문자와 숫자 48자가 붙은 형식입니다.
  • 키는 만들 때 한 번만 표시됩니다. 키의 키 기반 해시만 저장하므로 다시 표시할 수 없습니다. 대시보드에서는 앞 10자로 키를 구분합니다.
  • 계정당 활성 키는 최대 20개입니다. 20개가 모두 차 있으면 기존 키를 폐기해야 새 키를 만들 수 있습니다.
  • 키 생성은 계정당 시간당 30회로 제한됩니다. 이를 초과하면 Retry-After 헤더와 함께 429 rate_limit_exceeded 오류가 반환됩니다.
  • 키 폐기는 30초 이내에 적용됩니다.
  • 키에 만료일을 지정할 수 있습니다. 키는 해당 날짜 00:00 UTC에 작동을 멈추며, 이후 요청에는 This API key expired on 2026-12-31 00:00 UTC. 메시지와 함께 401 invalid_api_key 오류가 반환됩니다. 폐기하기 전까지는 만료된 키에 더 나중의 날짜를 지정해 다시 사용할 수 있습니다.
  • 플레이그라운드는 자동으로 관리되는 전용 키를 사용하며, 이 키는 목록에 표시되지 않습니다.

지출 한도

키마다 일일 한도, 월간 한도, 누적 예산을 원하는 조합으로 설정할 수 있습니다. 일과 월은 UTC 기준입니다. 누적 예산은 누적 예산 기능이 도입된 이후 해당 키가 사용한 금액을 집계합니다(기존 키는 도입 이전 사용량 중 마지막 30일분만 포함). 요청을 전달하기 전에 그 요청의 최대 예상 비용(속도 제한 및 체험에서 설명하는 임시 차감)을 해당 기간에 키가 이미 사용한 금액에 더합니다. 합계가 한도를 넘으면 요청은 402 key_spend_cap_reached 오류로 실패하며 비용은 청구되지 않습니다. 오류 메시지에는 어떤 한도(일일, 월간, 누적)에 걸렸는지가 표시됩니다. 스크립트나 팀원에게 정해진 예산 안에서만 쓸 수 있는 키를 줄 때 한도를 활용하면 좋습니다. 각 한도의 남은 금액은 GET /v1/balance에서 확인할 수 있습니다.

계정 번호와 API 키는 별개입니다

16자리 계정 번호는 웹사이트 로그인에 쓰입니다. 계정 번호는 API 키로 쓸 수 없고, API 키로는 웹사이트에 로그인할 수 없습니다. 둘 다 비밀로 유지하세요. 계정 번호를 가진 사람은 누구나 계정과 그 크레딧을 제어할 수 있습니다.

오류

요청을 처리할 때 계정 상태를 가장 먼저 확인합니다.

상태코드의미
401invalid_api_key키를 보내지 않았거나, 키 형식이 잘못되었거나, 알 수 없는 키이거나, 폐기 또는 만료된 키입니다.
403account_suspended계정이 정지되었습니다. 정지가 끝날 때까지 이 계정의 모든 키가 거부됩니다.
403account_banned계정이 차단되었습니다. 계정의 키는 폐기되고 남은 크레딧은 몰수됩니다.

전체 목록은 오류 페이지에 있습니다.

요청 ID

오류를 포함한 모든 응답에는 x-request-id 헤더가 있습니다. 지원팀에 문의하거나 문제를 신고할 때 이 값을 알려 주세요. 이 ID로 요청의 메타데이터(시각, 키, 모델, 토큰 수, 비용, 상태, 지연 시간)를 찾을 수 있으며, 메타데이터는 30일 동안 보관합니다. 프롬프트와 출력은 저장하지 않으므로(개인정보 처리방침 참고), 특정 요청을 가리킬 수 있는 방법은 요청 ID뿐입니다.