Source: https://ailoot.ai/docs/ko/cabinet/
Canonical: https://ailoot.ai/docs/ko/cabinet/
Language: ko

[대시보드 API](https://ailoot.ai/docs/ko/) 

# 대시보드 API

[Markdown](https://ailoot.ai/docs/ko/cabinet/index.md)

개인 대시보드의 로그인, 프로필, 키 및 비용 내역 메서드입니다.

ailoot.ai의 개인 대시보드 API입니다. 로그인, 프로필, 키 및 비용 내역을 제공합니다. 모델 요청은 다른 주소로 전송합니다: `https://api.ailoot.ai` — 인증 키: `sk-…`. 메서드 접근은 계정 권한과 활성화된 기능에 따라 다릅니다.

## [](https://ailoot.ai/docs/ko/cabinet/#adresa-i-avtorizatsiya)주소 및 인증

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

| 항목 | 주소 | 인증 |
| --- | --- | --- |
| 대시보드 API | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` — 로그인 후 발급된 대시보드 토큰 |
| 모델 API | `https://api.ailoot.ai/v1` | 키 `sk-…` «API 키» 메뉴에서 가져옵니다. 참고: [키와 API 주소](https://ailoot.ai/docs/ko/keys/) |

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

자신의 프로필 조회

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

## [](https://ailoot.ai/docs/ko/cabinet/#format-otveta-i-oshibki)응답 형식 및 오류

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

페이지가 포함된 응답 구조

```json
{
  "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 확인이 특정 요청을 차단할 수 있습니다.

## [](https://ailoot.ai/docs/ko/cabinet/#kak-chitat-spravochnik)참고 문서 읽는 방법

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

## [](https://ailoot.ai/docs/ko/cabinet/#balans-i-frozen-balance)잔액과 frozen\_balance

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

## [](https://ailoot.ai/docs/ko/cabinet/#klyuchi-i-limity)키와 제한

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

목록 및 자신의 키

```bash
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"
```

## [](https://ailoot.ai/docs/ko/cabinet/#rashody-i-bezopasnost)비용과 보안

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

이 섹션: `39` 개의 메서드.

궁금한 점이 남았나요? Request ID와 설명을 보내 주시면 해결을 도와드리겠습니다.[지원팀에 문의](mailto:support@ailoot.ai)

## Ailoot · 회사와 그 프로젝트 포트폴리오





Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.





회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.





Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.