API 개요

AllToken REST API 기초 — 인증, Base URL, 응답 형식.

Base URL

Base URL
$ https://api.alltoken.ai/v1

모든 API 엔드포인트는 이 Base URL을 기준으로 합니다. API는 OpenAI API 형식과 완전히 호환됩니다.

인증

모든 요청에는 Authorization 헤더에 Bearer Token이 필요합니다:

Header
$ Authorization: Bearer YOUR_API_KEY

설정 → API Keys에서 API Key를 발급받으세요.

응답 형식

모든 응답은 JSON 형식입니다. 성공 응답은 데이터를 직접 반환합니다. 오류 응답 형식은 다음과 같습니다:

오류 응답
1{
2 "error": {
3 "message": "Invalid API key provided",
4 "type": "authentication_error",
5 "code": 401
6 }
7}

상태 코드

  • 200 — 성공
  • 400 — 잘못된 요청 (파라미터 오류)
  • 401 — 인증되지 않음 (API Key 없음 또는 유효하지 않음)
  • 403 — 접근 금지 (권한 부족)
  • 404 — 리소스를 찾을 수 없음
  • 429 — 속도 제한 초과
  • 500 — 내부 서버 오류
  • 502/503 — 업스트림 공급자 오류 (자동 장애 조치 트리거 가능)