인증
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 키입니다.
# 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헤더와 함께 429rate_limit_exceeded오류가 반환됩니다. - 키 폐기는 30초 이내에 적용됩니다.
- 키에 만료일을 지정할 수 있습니다. 키는 해당 날짜 00:00 UTC에 작동을 멈추며, 이후 요청에는
This API key expired on 2026-12-31 00:00 UTC.메시지와 함께 401invalid_api_key오류가 반환됩니다. 폐기하기 전까지는 만료된 키에 더 나중의 날짜를 지정해 다시 사용할 수 있습니다. - 플레이그라운드는 자동으로 관리되는 전용 키를 사용하며, 이 키는 목록에 표시되지 않습니다.
지출 한도
키마다 일일 한도, 월간 한도, 누적 예산을 원하는 조합으로 설정할 수 있습니다. 일과 월은 UTC 기준입니다. 누적 예산은 누적 예산 기능이 도입된 이후 해당 키가 사용한 금액을 집계합니다(기존 키는 도입 이전 사용량 중 마지막 30일분만 포함). 요청을 전달하기 전에 그 요청의 최대 예상 비용(속도 제한 및 체험에서 설명하는 임시 차감)을 해당 기간에 키가 이미 사용한 금액에 더합니다. 합계가 한도를 넘으면 요청은 402 key_spend_cap_reached 오류로 실패하며 비용은 청구되지 않습니다. 오류 메시지에는 어떤 한도(일일, 월간, 누적)에 걸렸는지가 표시됩니다. 스크립트나 팀원에게 정해진 예산 안에서만 쓸 수 있는 키를 줄 때 한도를 활용하면 좋습니다. 각 한도의 남은 금액은 GET /v1/balance에서 확인할 수 있습니다.
계정 번호와 API 키는 별개입니다
16자리 계정 번호는 웹사이트 로그인에 쓰입니다. 계정 번호는 API 키로 쓸 수 없고, API 키로는 웹사이트에 로그인할 수 없습니다. 둘 다 비밀로 유지하세요. 계정 번호를 가진 사람은 누구나 계정과 그 크레딧을 제어할 수 있습니다.
오류
요청을 처리할 때 계정 상태를 가장 먼저 확인합니다.
| 상태 | 코드 | 의미 |
|---|---|---|
| 401 | invalid_api_key | 키를 보내지 않았거나, 키 형식이 잘못되었거나, 알 수 없는 키이거나, 폐기 또는 만료된 키입니다. |
| 403 | account_suspended | 계정이 정지되었습니다. 정지가 끝날 때까지 이 계정의 모든 키가 거부됩니다. |
| 403 | account_banned | 계정이 차단되었습니다. 계정의 키는 폐기되고 남은 크레딧은 몰수됩니다. |
전체 목록은 오류 페이지에 있습니다.
요청 ID
오류를 포함한 모든 응답에는 x-request-id 헤더가 있습니다. 지원팀에 문의하거나 문제를 신고할 때 이 값을 알려 주세요. 이 ID로 요청의 메타데이터(시각, 키, 모델, 토큰 수, 비용, 상태, 지연 시간)를 찾을 수 있으며, 메타데이터는 30일 동안 보관합니다. 프롬프트와 출력은 저장하지 않으므로(개인정보 처리방침 참고), 특정 요청을 가리킬 수 있는 방법은 요청 ID뿐입니다.