대시보드 API

• 대시보드: https://ailoot.ai (계정 로그인, 대시보드 토큰)
• 모델 API: https://api.ailoot.ai (sk-… 키)

키 sk-… 는 대시보드 토큰을 대신하지 않으며 대시보드 토큰도 모델 API에 접근할 수 없습니다. 전체 경로는 각 메서드에 표시됩니다.

curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

응답에는 code, message, data가 포함됩니다. 오류에 reason과 metadata가 있을 수 있습니다. data의 페이지 정보에는 items, total, page, page_size, pages가 포함됩니다. 개별 메서드의 형식은 해당 설명을 참고하세요.

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

대시보드 토큰은 만료 여부와 사용자 활성 상태를 기준으로 검증됩니다. 세션 바인딩을 사용하면 IP와 브라우저도 확인합니다. TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN, FORBIDDEN은 세션과 권한 문제를 구분합니다. 호출 빈도 제한과 추가 2FA 확인이 특정 요청을 차단할 수 있습니다.

• 각 항목에는 HTTP 메서드, 전체 경로, 접근 조건, 매개변수, 본문 필드 및 응답이 포함됩니다.
• 식별자는 이전 응답에서 가져오세요. KEY_ID는 GET /api/v1/keys에서, 요청 ID는 GET /api/v1/usage에서 가져옵니다.
• 객체 필드와 타입은 «데이터 스키마» 페이지를 참고하세요.
• 템플릿은 필드 이름과 타입을 보여줍니다. PLACEHOLDER와 TOKEN은 표식이며 실제 데이터가 아닙니다.
• 잔액 충전은 대시보드의 «요금» 메뉴에서 합니다: 충전 방법.

프로필에는 balance와 frozen_balance가 있습니다. frozen_balance는 진행 중인 요청에 예약된 금액입니다. 내역과 함께 두 필드를 모두 확인하세요.

GET /api/v1/keys는 자신의 키를 반환합니다. 필드 quota 및 quota_used — 키의 지출 한도 및 이미 사용한 금액; ip_whitelist, ip_blacklist, status 및 expires_at 은 키 사용을 제어하며, rate_limit_5h, rate_limit_1d 및 rate_limit_7d — 시간 창별 지출 한도입니다.

curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID는 목록 응답에 있는 본인 키의 id입니다
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

내역과 대시보드의 actual_cost는 실제 차감액, total_cost는 기본 요금으로 계산한 비용입니다. 날짜, 모델, 키, 요청 유형 필터는 각 메서드를 참고하세요. 비밀번호, TOTP, 패스키 변경에는 해당 메서드에서 설명한 확인 절차가 필요합니다.

이 섹션: 39 개의 메서드.