> 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.9.4/credit/manual/billing.md).

# 크레딧 과금

## 개요

크레딧은 GenOS에서 모델 호출 비용을 계량하고 통제하는 단위입니다. 관리자는 사용자와 관리 그룹에 매월 크레딧을 배정하고, 서빙 리비전에 토큰 단가를 설정합니다. 이후 모델을 호출하면 **응답이 끝난 직후 실제 사용한 토큰만큼 즉시 차감**되며, 잔액이 없으면 다음 호출이 차단됩니다.

관리자 콘솔 `크레딧 > 크레딧 현황`에서 배정과 사용 현황을 관리합니다.

<figure><img src="https://content.gitbook.com/content/oJuB29xjw7zmR91VXmqf/blobs/248P3dGRgoMszyhPxBXA/billing_01_credit_status.png" alt="크레딧 현황 — 관리 그룹"><figcaption><p>크레딧 현황 — 관리 그룹</p></figcaption></figure>

리비전별 월 예산 한도는 별도 문서로 분리했습니다 — 서빙 리비전 월 예산 매뉴얼.

## 주요 개념

| 개념         | 설명                                                              |
| ---------- | --------------------------------------------------------------- |
| 크레딧        | 모델 사용량을 환산한 과금 단위입니다. 매월 KST 1일 0시에 새 주기가 시작됩니다.                |
| 기본 크레딧     | 매월 자동으로 지급되는 크레딧입니다.                                            |
| 추가 크레딧     | 기본 크레딧과 별도로 부여하거나 차감하는 크레딧입니다.                                  |
| 초과 사용      | 기본·추가를 모두 쓴 뒤 응답 1건 때문에 잔액을 넘긴 분량입니다. 차단 전에 기록됩니다.              |
| 과금 계정      | 실제로 차감되는 대상입니다. 사용자 또는 관리 그룹 중 **하나**입니다.                       |
| 과금 턴       | 사용자의 질문 하나를 처리하는 동안의 모든 모델 호출 묶음입니다. 턴 안에서는 과금 계정과 과금 월이 고정됩니다. |
| 차감 크레딧(단가) | 서빙 리비전에 설정하는 입력·출력 토큰 단가입니다. 기준 토큰 수당 크레딧으로 지정합니다.              |
| 챗서비스 배수    | 챗서비스 리비전에 설정하는 보정계수입니다. 서빙 단가에 곱해집니다.                           |
| 원장         | 모든 호출의 사용량·차감 이력입니다. 면제 호출도 0원으로 기록됩니다.                         |
| 면제         | 플랫폼이 비용을 부담하는 호출입니다. 0원 이력만 남고 사용자 크레딧은 줄지 않습니다.                |

## 크레딧 배정

### 공통 기본 크레딧

모든 관리 그룹에 매월 자동 지급되는 값입니다. `크레딧 현황` 우측 상단 톱니 → `공통 기본 크레딧 설정`.

<figure><img src="https://content.gitbook.com/content/oJuB29xjw7zmR91VXmqf/blobs/tgIC2DkzMniHa9VURM3Q/billing_02_credit_common_default.png" alt="공통 기본 크레딧 설정"><figcaption><p>공통 기본 크레딧 설정</p></figcaption></figure>

이 값은 **대상별 기본 크레딧 설정이 없는 관리 그룹에만** 적용됩니다. 대상별로 값을 지정하면 그 값이 우선합니다.

### 대상별 크레딧 설정

톱니 → `대상별 크레딧 설정`에서 관리 그룹 또는 사용자를 골라 개별 지급량을 정합니다.

<figure><img src="https://content.gitbook.com/content/oJuB29xjw7zmR91VXmqf/blobs/5JFFerWNmHfRasUkyfZP/billing_03_credit_allocation.png" alt="대상별 크레딧 설정"><figcaption><p>대상별 크레딧 설정</p></figcaption></figure>

| 입력              | 의미                                        |
| --------------- | ----------------------------------------- |
| 기본 크레딧          | 매월 지급될 값. `공통 기본 크레딧 설정 적용`을 켜면 공통값을 따릅니다 |
| 추가 크레딧 — 크레딧 부여 | 이번 주기에 더 얹을 값                             |
| 추가 크레딧 — 크레딧 차감 | 이번 주기에 회수할 값                              |

저장 전에 `크레딧 설정 적용 결과`에서 변경 전후 값을 확인할 수 있습니다. 변경 내역은 화면 하단 `크레딧 설정 이력`에 변경자·변경 유형과 함께 남습니다.

### 사용 현황 읽기

`사용자` 탭에서 사용자별 지급량·사용량·잔여량·사용률을 봅니다.

<figure><img src="https://content.gitbook.com/content/oJuB29xjw7zmR91VXmqf/blobs/qzljWBeEsIpRLAsTLhbW/billing_04_credit_status_user.png" alt="크레딧 현황 — 사용자"><figcaption><p>크레딧 현황 — 사용자</p></figcaption></figure>

사용률 100%는 그 계정의 크레딧을 다 썼다는 뜻이고, 이 상태의 사용자는 다음 호출부터 차단됩니다. 상단의 월 이동 화살표로 지난 주기를 조회할 수 있습니다.

## 크레딧이 차감되는 순간

차감은 **응답이 끝난 직후**에 일어납니다. 호출 전에는 잔액이 있는지만 확인합니다.

```
질문
 → (호출 직전) 단가·잔액·MQ 상태 확인 → 잔액 없으면 여기서 차단
 → 모델 호출
 → 응답에서 실제 사용 토큰 추출
 → 원장 기록 + 크레딧 차감
```

이 구조에서 나오는 성질이 세 가지 있습니다.

* **이미 시작한 응답은 중간에 끊지 않습니다.** 잔액이 조금이라도 남아 있으면 그 호출은 통과하고, 실제 사용량이 잔액을 넘긴 만큼은 `초과 사용`으로 기록됩니다. 차단은 그 다음 호출부터입니다.
* **차단된 호출은 토큰을 쓰지 않습니다.** 모델을 부르기 전에 막기 때문입니다.
* **한 질문은 한 계정에서만 차감됩니다.** 사용자와 그룹에 모두 크레딧이 있으면 턴 첫 호출에서 하나를 고르고 그 턴이 끝날 때까지 바꾸지 않습니다. 청구가 두 계정으로 쪼개지지 않게 하려는 의도이므로, 고른 계정이 턴 도중 소진되면 다른 쪽에 잔액이 남아 있어도 차단됩니다.

## 과금되는 것과 되지 않는 것

### 과금되는 호출

| 호출                                       | 과금 대상                                  |
| ---------------------------------------- | -------------------------------------- |
| 채팅에서 사용자가 보낸 질문                          | 그 사용자(또는 소속 관리 그룹)                     |
| **보고서 생성**의 주제·목차·본문 생성 호출               | 보고서를 요청한 사용자. 워크플로우를 거쳐도 면제로 바뀌지 않습니다  |
| 파일 첨부·드라이브 문서의 RAG 질의 임베딩                | 질문한 사용자                                |
| 인증 키로 직접 호출한 서빙                          | 인증 키의 소유자                              |
| 인증 키로 호출한 워크플로우가 내부에서 부른 서빙              | 같은 인증 키 소유자 — 워크플로우를 거쳐도 귀속이 달라지지 않습니다 |
| 장기 메모리의 검색(recall)·명시 저장(save)           | 요청한 사용자                                |
| 비-Triton 모델 서빙의 수동 테스트·수동 복구             | 실행한 관리자                                |
| Triton 실제 추론(`/v2/models/{model}/infer`) | 일반 과금 대상                               |

### 과금되지 않는 호출

먼저 알아 둘 것이 있습니다 — **크레딧 게이트는 "추론이냐"가 아니라 "게이트웨이의 서빙 경로를 지나가느냐"에 걸립니다.** 그래서 토큰을 한 개도 쓰지 않는 제어 호출(예: LoRA 어댑터 load/unload)도 기본적으로 과금 후보이고, 아래 표는 "과금해야 할 목록"이 아니라 **각 호출이 어느 예외에 속하는지 못박아 둔 목록**입니다. 예외 선언이 빠지면 그 호출은 요청자에게 청구되거나, 주체가 없으면 무귀속 무과금으로 새어 나갑니다.

과금되지 않는 이유는 네 가지로 갈립니다. **원장에 남는지**가 다릅니다.

| 유형        | 이유                                                                         | 원장       |
| --------- | -------------------------------------------------------------------------- | -------- |
| 면제        | 플랫폼이 비용을 부담한다고 선언된 호출                                                      | 0원 이력 남음 |
| 단가 미설정    | 서빙 리비전에 차감 크레딧이 없음                                                         | 0원 이력 남음 |
| 챗서비스 배수 0 | 챗서비스에 크레딧 설정을 하지 않음                                                        | 0원 이력 남음 |
| 필터 제외 경로  | 상태 확인용 경로 (`/health`, `/healthcheck`, Triton `/v2/health/*`, `/v2/models`) | 이력 없음    |

면제 사유는 4종입니다.

| 사유                  | 대상                                                           |
| ------------------- | ------------------------------------------------------------ |
| `ai_meeting`        | AI 회의록의 STT·요약 호출                                            |
| `memory_system`     | 장기 메모리의 **추출**(관리자가 `memory_credit_subject=system`으로 설정한 경우) |
| `platform_internal` | 플랫폼이 자동 수행하는 내부 작업 (아래 표)                                    |
| `test_session`      | 챗서비스 관리자 테스트 채팅                                              |

> 면제된 작업이 사용자에게 과금되고 있다면 워크플로우 전파 설정을 확인하세요. 워크플로우를 거치는 면제는 플랫폼 전파 헤더 목록에 의존하며, 거기서 면제 헤더가 빠지면 **차단이 아니라 요청 사용자에게 과금되는 방향으로 조용히 실패합니다.**

> 면제는 헤더만 보고 인정하지 않습니다. 게이트가 발신 신원(mTLS 인증서)과 세션·주체를 사유별로 다시 검증합니다. **클라이언트가 면제 헤더를 직접 보내도 적용되지 않습니다.**

### 관리자 작업과 플랫폼 작업

관리자 화면에서 시작했더라도, 사람이 직접 모델을 확인하는 호출과 플랫폼이 자동으로 도는 호출은 다르게 처리합니다.

| 작업                                      | 크레딧             | 원장                          |
| --------------------------------------- | --------------- | --------------------------- |
| 비-Triton 모델 서빙 수동 테스트·수동 복구             | 실행 관리자에게 과금     | 일반 유료 호출과 동일                |
| service-router 수동 복구(`auto=False`)      | 실행 관리자에게 과금     | 실제 probe 사용량 과금             |
| service-router 자동 복구 probe(`auto=True`) | 플랫폼 흡수          | `platform_internal` 0원 이력   |
| LoRA load/unload                        | 플랫폼 흡수          | `platform_internal` 0원 이력   |
| 관리자 데이터관리 동기 임베딩                        | 플랫폼 흡수          | `platform_internal` 0원 이력   |
| RDBMS 자동 수집, 문서 파서의 내부 임베딩              | 플랫폼 흡수          | `platform_internal` 0원 이력   |
| 데이터분석의 내부 모델 호출                         | 플랫폼 흡수          | `platform_internal` 0원 이력   |
| **보고서 생성**의 내부 모델 호출                    | **요청 사용자에게 과금** | 일반 유료 호출과 동일                |
| 내부 모델 서빙 Langfuse 자동 평가                 | 플랫폼 흡수          | `platform_internal` 0원 이력 ⏸ |
| 문서 파서·Langfuse가 외부 provider를 직접 호출      | GenOS 과금 대상 아님  | 이력 없음 (외부 provider 계약을 따름)  |
| `/health`, `/healthcheck`, Triton 상태 경로 | 필터 제외           | 이력 없음                       |

⏸ Langfuse 항목은 정책 계약입니다. 이미 저장된 Langfuse connection은 코드 배포만으로 갱신되지 않으므로, 승인된 재동기화와 저장 상태 확인이 끝나기 전에는 적용됐다고 보지 않습니다.

**보고서 생성과 데이터분석은 정책이 다릅니다.** 둘 다 워크플로우를 거치지만, 보고서는 사용자가 요청한 산출물이므로 **요청 사용자에게 과금**하고, 데이터분석은 플랫폼이 흡수합니다. 보고서 경로는 전달 과정의 실수로 과금이 사라지지 않도록 **넘어온 면제 헤더를 경계에서 제거**합니다.

여기서 말하는 "모델 서빙 수동 테스트"는 챗서비스의 **테스트 채팅과 다릅니다.** 테스트 채팅은 검증된 `test_session` 조건을 만족할 때만 면제입니다. 플랫폼 흡수도 내부 Pod이라는 이유만으로 적용되지 않고, 게이트가 발신 신원과 면제 사유를 모두 검증한 경우에만 적용됩니다.

## 사용량 확인

`서빙 > 모델 서빙`에서 워크스페이스와 서빙 유형을 고른 뒤 대상 행을 엽니다.

<figure><img src="https://content.gitbook.com/content/oJuB29xjw7zmR91VXmqf/blobs/1FLmdHwYJQwULk5eZCOf/billing_05_serving_list.png" alt="서빙 목록"><figcaption><p>서빙 목록</p></figcaption></figure>

### 리비전별 사용량

`기본 정보 > 모델 상세 배포 이력`에서 확인합니다.

<figure><img src="https://content.gitbook.com/content/oJuB29xjw7zmR91VXmqf/blobs/nY8LOJXu5xpYJTze2Q1k/billing_06_deploy_history_tokens.png" alt="배포 이력 토큰"><figcaption><p>배포 이력 토큰</p></figcaption></figure>

| 항목      | 의미                        |
| ------- | ------------------------- |
| 요청 수    | 해당 배포 구간에 원장에 적재된 완료 응답 수 |
| 입력 토큰 수 | 프롬프트 토큰 누계                |
| 출력 토큰 수 | 생성 토큰 누계                  |

배포일부터 중지일까지 집계하며, 실행 중인 배포는 현재까지 표시합니다. 임베딩·리랭킹·이미지 계열은 토큰 대신 요청 수만 표시합니다.

### 인증 키별 사용량

`인증 키` 탭에서 키별 요청 수와 입력·출력 토큰 누계를 확인합니다.

<figure><img src="https://content.gitbook.com/content/oJuB29xjw7zmR91VXmqf/blobs/FjqBUSz7I38GpbfJE23m/billing_07_authkey_tokens.png" alt="인증 키 토큰"><figcaption><p>인증 키 토큰</p></figcaption></figure>

키를 팀이나 용도별로 나누면 사용량도 같은 기준으로 구분됩니다. 인증 키에는 과금 주체(소유자)가 있으며, **다른 사람을 소유자로 지정하는 것은 슈퍼관리자만 가능합니다.** 지정하지 않으면 키를 만든 사람에게 귀속됩니다.

### 숫자를 읽을 때

* 서빙 사용량은 원장(`credit_update_history`)을 기준으로 집계합니다.
* 인증 키 토큰은 전환 전 동결 누계와 전환 후 원장 증가분을 합쳐 표시합니다. 전환 이전 데이터의 원본 토큰은 분할 이력을 합쳐 복원하므로 근사치일 수 있습니다.
* 모델 제공자가 사용량(`usage`)을 내려주지 않으면 토큰은 0으로 기록됩니다.
* 중도 취소나 스트림 오류를 게이트웨이가 확인하면 보통 원장 이벤트를 만들지 않습니다.
* 요청 수와 토큰 수는 별도 조건으로 집계하므로 화면 간 요청 수가 항상 같지는 않습니다.
* 더 자세한 호출 내역은 `이용 로그` 탭에서 개별 호출의 입출력과 소요 시간으로 확인합니다.

## 차단 코드와 조치

차단 응답은 기존 API 규약과 동일하게 **HTTP 200**입니다. 응답 본문의 `code: 1`과 `error_code`, `errMsg`로 판단해야 합니다. HTTP 상태만 보는 클라이언트는 실패를 성공으로 읽습니다.

| 코드         | 의미                                                    | 조치                      |
| ---------- | ----------------------------------------------------- | ----------------------- |
| `13030001` | 크레딧 소진 — 질문 첫 호출                                      | 해당 계정에 크레딧 추가 배정        |
| `13030002` | 크레딧 소진 — 답변 도중                                        | 위와 같음. 이미 생성된 답변은 유지됩니다 |
| `13030003` | 리비전 월 예산 소진 — 첫 호출                                    | 예산 매뉴얼 참고               |
| `13030004` | 리비전 월 예산 소진 — 답변 도중                                   | 예산 매뉴얼 참고               |
| `13030005` | 과금 주체 확인 실패 — **워크플로우 실행 시작 시점에만 발생**                 | 세션·인증·서비스 토큰 확인         |
| `13030006` | 판정 근거를 확인할 수 없음 (admin snapshot·Redis·RabbitMQ 일시 장애) | 관련 서비스 상태 확인            |
| `13030007` | 서빙·리비전 요청 계약 오류                                       | 호출 URL과 실행 리비전 확인       |

### 과금 주체를 확인할 수 없는 서빙 호출은 막지 않습니다

서빙 호출에서 과금 주체를 확정하지 못하면 **차단하지 않고 통과시키되 차감하지 않습니다.** 사용 이력은 그대로 남으므로 사용량 집계와 사후 소명이 가능합니다.

* 해당하는 경우: 인증 키로 호출한 워크플로우의 중첩 서빙 중 소유자를 찾을 수 없는 것, Flowise 빌더에서 챗플로우를 직접 테스트하는 경우
* 인증 키 소유자를 확인할 수 있으면 **그 소유자에게 정상 과금**됩니다.
* 관리자 확인: 이력에서 사용 주체가 비어 있는 행으로 조회됩니다. 이런 행이 계속 늘어나면 인증 키에 소유자가 지정돼 있는지 확인하세요. 이 상태는 차단이 아니라 **매출 누락**입니다.

크레딧 소진(`13030001`·`13030002`), 월 예산 소진(`13030003`·`13030004`), 일시 장애(`13030006`)는 그대로 차단됩니다. 특히 정산 대기열이 멈춘 상태(`13030006`)에서는 이력을 남길 수 없으므로 무과금 통과를 적용하지 않습니다 — 기록 없이 통과시키면 "차감 없이 집계"가 아니라 "기록 없는 무제한 무료"가 됩니다.

## 동작 예시

실제로 이렇게 동작합니다. 각 항목은 배포 검증 시나리오에서 뽑은 것입니다.

### 정상 과금과 소진

| 상황                         | 결과                                   |
| -------------------------- | ------------------------------------ |
| 잔액 충분, 단가 설정된 서빙에 질문 1회    | 정상 응답. 응답 직후 차감                      |
| 잔액 0인 사용자가 새 질문            | `13030001` 차단. 모델을 부르지 않으므로 토큰 소비 없음 |
| 서빙을 여러 번 부르는 워크플로우가 도중에 소진 | `13030002`. **이미 받은 응답은 유지**         |
| 가드레일이 입력을 차단               | 모델 미호출 → 과금 이벤트 없음, 잡아둔 예약도 해제       |
| 모델이 5xx로 실패해 재시도           | 실패 시도는 과금 이벤트를 만들지 않음. 최종 성공만 과금     |

### 과금 계정 선택

| 상황                   | 결과                                       |
| -------------------- | ---------------------------------------- |
| 사용자·그룹 양쪽에 크레딧       | 한 질문의 모든 호출이 같은 계정·같은 과금 월로 기록           |
| 사용자 크레딧 소진, 그룹 잔액 있음 | 턴 첫 호출에서 그룹을 골라 턴 끝까지 고정                 |
| 턴 도중 고정된 계정이 소진      | 다른 쪽에 잔액이 남아도 `13030002` — 청구 분할 방지      |
| 사용자·그룹 모두 크레딧 미배정    | 통과 + 감사 이력만. 이후 크레딧이 배정돼도 **소급 차감하지 않음** |
| 질문 처리 중 달이 바뀜        | 첫 호출의 과금 월로 고정 (턴 안에서 월 불변)              |

### 단가·배수 설정에 따른 차이

| 설정                             | 결과                                        |
| ------------------------------ | ----------------------------------------- |
| 서빙 단가 있음 + 챗서비스 배수 있음          | 단가 × 배수로 과금                               |
| 서빙 단가 있음 + 챗서비스에 크레딧 설정 없음     | **무과금**(배수 0). 지연정산 시절과 동일                |
| 서빙 단가 있음 + 챗서비스 미지정(직접 API 호출) | 배수 1배로 과금                                 |
| 장기 메모리·AI 회의록처럼 챗서비스가 없는 세션    | **배수 0 규칙을 적용하지 않습니다** — 서빙 단가가 그대로 반영됩니다 |
| 서빙 단가 없음                       | 통과 + 0원 이력                                |
| 입력 단가만 설정(한쪽 축 누락)             | `13030006` 차단 — 없는 축을 0으로 간주하지 않습니다       |
| 같은 서빙 리비전을 여러 챗서비스가 사용         | 각자의 배수가 적용됩니다                             |
| 호출 후 단가를 바꿈                    | 이미 시작한 호출은 **호출 시점 단가**로 차감               |

### 인증 키 호출

| 상황                        | 결과                          |
| ------------------------- | --------------------------- |
| 인증 키로 서빙 직접 호출            | 키 소유자에게 차감. 이력에 인증 키가 함께 기록 |
| 인증 키로 워크플로우 호출(내부에 서빙 포함) | **직접 호출과 동일하게** 키 소유자에게 과금  |
| 소유자가 지정되지 않은 옛 인증 키       | 통과 + 무과금 이력. 소유자 지정 필요      |
| 일반 관리자가 타인을 소유자로 지정 시도    | `05040012` 거부 (슈퍼관리자만 가능)   |
| 소유자 필드를 빼고 키를 수정          | 기존 소유자 유지 — 빈 값으로 지워지지 않습니다 |

### 면제

| 상황                                        | 결과                                          |
| ----------------------------------------- | ------------------------------------------- |
| AI 회의록의 STT·요약                            | 차감 없음 + 0원 이력(`ai_meeting`)                 |
| 장기 메모리 추출(`memory_credit_subject=system`) | 차감 없음(`memory_system`)                      |
| 장기 메모리 검색·명시 저장                           | **사용자에게 차감** — 현재 사용자 요청을 처리하는 호출이므로 설정과 무관 |
| 테스트 채팅에서의 장기 메모리                          | 검색·저장 도구가 노출되지 않아 애초에 호출되지 않음               |
| 챗서비스 관리자 테스트 채팅                           | 차감 없음(`test_session`)                       |
| 클라이언트가 면제 헤더를 위조해 전송                      | 무시. 신원·세션·주체 검증에 실패하면 면제 아님                 |
| 알 수 없는 면제 사유 문자열                          | 인정하지 않음                                     |

### 사용자에게 보이는 문구 (gen-portal 채팅)

| 상황            | 화면                              |
| ------------- | ------------------------------- |
| 첫 질문에서 크레딧 소진 | "사용할 수 있는 크레딧을 모두 사용했습니다" 계열 문구 |
| 답변 도중 소진      | 부분 답변 유지 + 배지 + 사유 한 줄          |
| 모델 월 예산 소진    | 크레딧 소진과 **구분되는** 모델 한도 문구       |
| 알 수 없는 코드     | 일반 실패 문구로 폴백                    |
| 과거 세션 재진입     | 라이브 경로와 동일한 문구                  |

## 자주 묻는 질문

**요청 수는 늘었는데 토큰이 그대로입니다.**

모델 제공자가 사용량을 내려주는지, 클라이언트가 스트림을 끝까지 읽는지 확인합니다.

**배포 이력과 인증 키의 요청 수가 다릅니다.**

배포 이력은 원장에 적재된 완료 응답을, 인증 키는 해당 키로 들어온 요청을 기준으로 합니다. 연결 실패·중도 취소·MQ 발행 실패·내부 호출 때문에 값이 다를 수 있습니다.

**크레딧을 배정했는데 여전히 막힙니다.**

배정은 현재 주기 행에 반영됩니다. 잠시 뒤 다시 시도해도 막히면 차단 코드를 확인하세요 — `13030003`/`13030004`는 계정 잔액이 아니라 **리비전 월 예산** 소진입니다.

**채팅은 되는데 API 직접 호출만 막힙니다.**

챗서비스를 거치는 호출은 챗서비스 배수를 따르고, 챗서비스에 크레딧 설정이 없으면 무과금입니다. 반면 직접 API 호출은 배수 1배로 과금되므로 잔액이 있어야 합니다.

**월 1일 직후에 `13030006`이 몰립니다.**

주기가 바뀌면 모든 계정 스냅샷이 한꺼번에 낡아 admin-api 갱신에 의존합니다. **주기 경계 전후에는 admin-api를 배포하지 않습니다.**

***

관련 문서: 크레딧 즉시차감 아키텍처 · 크레딧 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.