> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.8.7/credit/manual.md).

# 크레딧 설명 및 정책

이 섹션에서는 GenOS의 크레딧 메뉴를 이해하고 활용하는 데 도움을 주기 위해 작성되었습니다.

관리자는 크레딧 현황을 실시간으로 모니터링하고, 비용을 조회하여, AI 서비스를 효율적으로 운영할 수 있습니다.

## 크레딧 종류

* 크레딧은 할당 범위와 지급 형태(월 정기 / 일시)로 구분됩니다.
* 월 정기 크레딧은 매 월 1일 00:00 에 지급됩니다.
  * **A. 공통 기본 크레딧 (월 정기)**
    * 조직 전체에 적용되는 크레딧입니다.
    * 모든 관리 그룹에 정기적으로 지급됩니다.
    * 주기에 따라 잔여 크레딧은 이월되지 않고 소멸됩니다.
  * **B. 관리 그룹 크레딧**
    * 특정 관리 그룹을 선택하여 직접 할당하는 크레딧입니다.
    * 기본 크레딧과 추가 크레딧을 부여할 수 있습니다.
      * 관리 그룹 기본 크레딧 (월 정기) : 주기에 따라 정기 지급되며, 잔여 크레딧은 이월되지 않고 소멸됩니다.
      * 관리 그룹 추가 크레딧 (일시) : 필요 시 지급되며, 미사용 잔여 크레딧은 이월됩니다.
  * **C. 사용자 크레딧**
    * 특정 사용자를 선택하여 직접 할당하는 크레딧입니다.
    * 기본 크레딧과 추가 크레딧을 부여할 수 있습니다.
    * 사용자 크레딧은 관리 그룹 크레딧 총 한도에 포함되지 않습니다.
      * 사용자 기본 크레딧 (월 정기) : 주기에 따라 정기 지급되며, 잔여 크레딧은 이월되지 않고 소멸됩니다.
      * 사용자 추가 크레딧 (일시) : 필요 시 지급되며, 미사용 잔여 크레딧은 이월됩니다.
  * **D. 초과 크레딧**
    * 요청 완료 시점에 차감해야 할 크레딧이 잔여 크레딧 합계를 초과하는 경우 발생하는 크레딧입니다.
      * 발생 케이스
        * 메시지 전송 시점에는 충분했으나, 응답 시점에 부족 시
        * 응답 초반엔 크레딧 존재 했으나, 생성 도중 토큰 증가로 한도 초과 시
        * 여러 사용자가 동시에 요청 시, 선점한 요청은 통과 하고 후속 요청 응답 시점에 부족 시
        * 관리 정책 변경과 충돌 시 (예. 관리자 정책 변경으로 크레딧 감소하여 응답 시점에 부족 시)
      * 초과 크레딧 발생 기준
        * 초과 크레딧은 초과 직전 마지막 잔여 사용 주체를 기준으로 합니다.
          * 케이스1. 예) 사용자 1, 관리 그룹 0
            * 마지막 잔여 사용 주체가 사용자이므로, 사용자 기준으로 초과 크레딧이 산정됩니다.
          * 케이스2. 예) 사용자 0, 관리 그룹 1
            * 마지막 잔여 사용 주체 관리 그룹이므로, 관리 그룹 기준으로 초과 크레딧이 산정됩니다.
          * 케이스 3. 예) 사용자 1, 관리 그룹 1
            * 사용자 > 관리 그룹 순으로 차감되므로 마지막 잔여 사용 주체는 관리 그룹이므로 관리 그룹 기준으로 초과 크레딧이 산정됩니다.
          * 케이스 4. 예) 사용자 0, 관리 그룹 0
            * 사용자 > 관리 그룹 순으로 차감되므로 마지막 잔여 사용 주체는 관리 그룹이므로 관리 그룹 기준 초과 크레딧이 산정됩니다.
  * **E. 기본 크레딧 (임시)**
    * 정책 변경으로 인해 변경된 지급량 보다 현재 사용량이 더 큰 경우 발생되는 크레딧 개념입니다.
      * 임시 기본 크레딧의 지급량은 현재 사용량 기준으로 산정합니다.
      * 다음 주기부터 변경된 정책이 정상 적용됩니다. 비고 내역에서 상세 내역을 확인할 수 있습니다.

## 크레딧 차감 정책

* **기본 원칙**
  * 응답이 ‘정상 완료’된 시점에 차감됩니다.
  * 요청 처리 시점에 크레딧이 부족하더라도 해당 요청은 정상 완료되며, 초과 크레딧으로 기록됩니다.
* **차감 케이스**
  * 채팅 응답이 정상적으로 완료된 경우
  * 입/출력 가드레일로 응답이 차단된 경우
    * 사용자에게 최종 답변이 전달되지 않더라도 크레딧은 차감됩니다.
* **미차감 케이스**
  * 응답 생성 실패로 완료되지 않은 경우
  * 사용자가 수동 중단한 경우
  * 테스트 창에서의 토큰 사용
    * 크레딧 : 미차감
    * 비용 : 계산됨
* **크레딧 소멸 및 이월 정책**
  * 기본 크레딧(정기) : 기간 내 미사용 잔여 크레딧은 이월되지 않으며 소멸됩니다.
  * 추가 크레딧(일시) : 미사용 잔여 크레딧은 이월됩니다.
* **크레딧 차감 우선순위**
  * 단위 우선순위
    1. 사용자
    2. 관리 그룹
  * 각 단위 내 차감 순서
    * **‘기본 크레딧 → 추가 크레딧’**
  * 사용자 기본 → 사용자 추가 → 그룹 공통 기본 → 그룹 추가 순서로 소진됩니다.
* **크레딧 상태가 소진 되었을 시**
  * 모든 크레딧 합계가 0 이하일 시 크레딧 차감 없는 채팅은 사용 가능하며, 크레딧 차감 필요한 채팅은 사용이 불가합니다.

## 비용 발생 정책

* **기본 원칙**
  * 플랫폼에서 관리하고 있는 외부 서빙 API 요청이 정상 완료되는 시점에 확정됩니다.
    * 따라서 입/출력 가드레일에 의해 응답이 차단된 경우에도 비용은 발생됩니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://genos-docs.gitbook.io/default/v1.8.7/credit/manual.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.