> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 사용량

> 토큰 잔액, 기간별 지출, 요청 이력, 충전.

<Info>
  **Black 등급 전용.** 하나의 공유 예산이 [AI 자동 조정](/ko/moderation/ai-auto-mod)과 [AI 서버 컨트롤](/ko/moderation/ai-server-control)에 모두 사용됩니다 — 기능별 할당은 별도로 없습니다.
</Info>

## 두 개의 풀

잔액은 두 개의 풀 합계이며 다음 순서로 소비됩니다:

<CardGroup cols={2}>
  <Card title="월간 지급" icon="calendar">
    **10,000,000 토큰**, 30일 주기로 재충전. 미사용 토큰은 이월되지 **않습니다**.
  </Card>

  <Card title="충전" icon="plus">
    구매한 토큰. **만료되지 않으며**, 갱신과 플랜 변경에도 유지됩니다.
  </Card>
</CardGroup>

지급분이 항상 먼저 소비되므로 충전은 매월 조용히 소모되는 것이 아니라 진짜 예비고 역할을 합니다.

<Warning>
  **"Resets in" 수치는 지급 주기가 아니라 결제일을 따릅니다.** 연간 Black 구독의 경우 지급이 실제로는 30일마다 채워지는 동안 수백 일로 표시될 수 있습니다.

  **Monthly grant** 수치 자체를 확인하세요 — 10,000,000으로 돌아오면 주기가 롤오버된 것입니다.
</Warning>

## 개요

| 타일                         | 카운트 대상                |
| -------------------------- | --------------------- |
| **Token Balance**          | 지급 + 충전 — 실제 사용 가능한 양 |
| **Tokens Used Today**      | 오늘 지금까지, UTC 기준       |
| **Tokens Used This Month** | 이번 달 현재까지             |
| **Requests Today**         | 토큰이 아닌 AI 호출 수        |
| **Input / output tokens**  | 오늘과 이번 달 세부           |

<Note>
  일자는 서버 시간대가 아닌 **UTC 자정**에 롤오버됩니다.
</Note>

<Note>
  월간 수치는 최대 5분 캐시됩니다. 활발한 활동 직후에는 일일 타일이 월간보다 먼저 업데이트됩니다 — 불일치가 아니라 갱신 속도가 다를 뿐입니다.
</Note>

**Token Usage** 차트는 7일, 14일, 30일에 걸쳐 입력과 출력을 스택 영역으로 표시합니다. 활동이 없는 날은 공백이 아니라 0으로 표시됩니다.

**Top Token Consumers**는 **오늘** 활동 비용이 가장 큰 10명의 멤버를 요청 수와 요청당 평균 비용과 함께 나열합니다. 표시할 것이 있을 때만 나타납니다.

<Tip>
  이 목록의 상위에 매일 있는 멤버는 대체로 이미지를 많이 게시합니다. 자동 조정은 메시지당 최대 4개 이미지를 스캔하고, 이미지는 텍스트보다 훨씬 비쌉니다.
</Tip>

## 활동

모든 AI 요청, 최신순, 페이지당 20개.

| 컬럼          | 참고                                         |
| ----------- | ------------------------------------------ |
| **Content** | 메시지, 잘림 처리. 자동 조정 스캔은 "Auto-Mod scan"으로 표시 |
| **Tokens**  | 합계, 입력과 출력 분리                              |
| **Source**  | "Auto-Mod", "AI Server Control", 또는 요청한 멤버 |
| **Status**  | Completed, Failed, Blocked, Rate limited 등 |
| **Time**    | 최근 항목은 상대 시간, 하루 이상은 날짜                    |

AI 서버 컨트롤 행은 확장되어 실행한 각 동작을 표시합니다 — 성공은 체크 표시, 거부된 동작은 방패, 오류는 X — 그리고 각 동작에 걸린 시간.

<Note>
  요청 이력은 **30일** 보관됩니다. 차트와 내보내기는 최대 90일까지 조회되므로 개별 행이 사라진 후에도 오래된 지출이 총합에 남아 있습니다.
</Note>

<Warning>
  시간 초과나 오류로 종료된 서버 컨트롤 실행은 청구되고 총합에 반영되지만 Activity 행을 생성하지 않습니다. 일일 총합이 보이는 행보다 높아 보인다면 이 때문입니다.
</Warning>

## 내보내기

**Export CSV**는 지난 **30일**을 다운로드합니다 — 하루당 하나의 행이며 입력, 출력, 총 토큰, 요청 수, 동작 수가 포함됩니다. 차트의 기간 선택기는 내보내기 범위를 변경하지 않습니다.

## 충전

**500,000 토큰당 \$1**, 1, 5, 10, 25, 50, 100 단위 블록으로.

<Steps>
  <Step title="금액 선택">
    대화 상자에 선택에 따른 총 토큰과 가격이 표시됩니다.
  </Step>

  <Step title="체크아웃 완료">
    Paddle로 이동해 결제합니다.
  </Step>

  <Step title="토큰 지급">
    결제 확인 시 충전 풀에 추가됩니다.
  </Step>
</Steps>

<Note>
  **Top Up Tokens** 버튼은 서버가 Paddle을 통해 결제되는 활성 Black 구독을 가진 경우에만 표시됩니다. 부여된 또는 무료 제공된 Black 등급 서버는 등록된 결제 수단이 없어 충전할 수 없습니다.
</Note>

<Warning>
  **결제 즉시 잔액이 업데이트되지 않습니다.** 잠시 후 페이지를 새로고침하고, AI 기능이 이미 일시 중지되었다면 재개되기까지 조금 더 기다리세요.
</Warning>

<Note>
  모든 구매는 결제 제공자가 확인을 두 번 이상 보내더라도 정확히 한 번만 지급됩니다. 환불은 토큰을 다시 차감합니다.
</Note>

## 예산이 소진될 때

두 기능은 서로 다른 시점에 중지됩니다. 서버 컨트롤 실행은 단일 메시지 스캔보다 훨씬 더 많은 여유가 필요하기 때문입니다.

| 잔액         | 효과                               |
| ---------- | -------------------------------- |
| 100,000 미만 | 자동 조정이 일회성 "잔액 부족" 안내 게시         |
| 30,000 미만  | **AI 서버 컨트롤이 새 요청 거절**           |
| 3,000 미만   | **AI 자동 조정 스캔 중지** 및 일시 중지 안내 게시 |

<Warning>
  자동 조정은 **안전-우선**입니다. 예산이 있는지 확인할 수 없으면 스캔하지 않습니다 — 잔액이 회복될 때까지 서버에는 AI 조정이 없게 됩니다.
</Warning>

안내는 자동 조정 알림 채널에 게시되며, 없으면 로그 채널로 폴백됩니다.

## 지출 줄이기

<AccordionGroup>
  <Accordion title="이미지 스캔 끄기">
    가장 큰 절약. 이미지 4개가 있는 메시지 하나는 1회가 아니라 5회 AI 호출입니다.
  </Accordion>

  <Accordion title="신뢰 등급 활성화">
    오래된 깨끗한 멤버는 매번 스캔되는 대신 샘플링됩니다 — 초대, 대량 멘션, 링크는 여전히 항상 검사됩니다.
  </Accordion>

  <Accordion title="바쁘지만 위험도가 낮은 채널 제외">
    봇 명령 채널이나 신뢰받는 단골이 있는 밈 채널은 유료 스캔이 필요하지 않습니다.
  </Accordion>

  <Accordion title="시행하지 않는 카테고리 비활성화">
    꺼진 카테고리는 절대 평가되지 않습니다.
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="활성 Black 플랜인데 잔액이 0으로 표시돼요">
    페이지를 새로고침하세요. 계속 이 상태라면 이 특정 서버의 구독 기록이 확인되지 않을 수 있습니다 — 프리미엄 페이지의 구독 아래에 서버가 나타나는지 확인하세요.
  </Accordion>

  <Accordion title="결제했는데 잔액이 움직이지 않아요">
    잠시 기다렸다가 새로고침하세요. AI가 이미 일시 중지되었다면 대시보드에 새 수치가 표시되는 것보다 재개에 조금 더 시간이 걸릴 수 있습니다.
  </Accordion>

  <Accordion title="내보내기가 다운로드 대신 원시 텍스트를 엽니다">
    다운로드에서 로그인 실패입니다. 대시보드를 새로고침해 세션을 갱신한 후 다시 시도하세요.
  </Accordion>

  <Accordion title="오늘 토큰은 많은데 Activity 목록이 짧아요">
    자동 조정은 메시지당 1회 호출과 이미지당 1회를 청구하므로 이미지가 많은 활동은 빠르게 배가됩니다. 실패한 서버 컨트롤 실행도 행 없이 청구됩니다.
  </Accordion>

  <Accordion title="두 기능 사이에 예산을 나눌 수 있나요?">
    아니요 — 하나의 공유 풀입니다. 자동 조정이 소모하고 있다면 기능별 상한을 찾기보다 자동 조정의 제외나 신뢰 등급을 강화하세요.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI 자동 조정" icon="sparkles" href="/ko/moderation/ai-auto-mod">
    대부분의 토큰 지출이 발생하는 곳.
  </Card>

  <Card title="AI 및 토큰" icon="crown" href="/ko/premium/ai">
    Black 등급 AI 할당 방식.
  </Card>
</CardGroup>