GLM Coding Plan 한도가 남았는데 잔액이 차감되는 이유

Standard·Coding Plan·기존 Compatible 키를 구분하고 GLM 과금 경로를 추적합니다. 한도 오류와 요청 속도 제한, 모델 권한 문제를 구별하세요.

모양이 다른 승차권이 알맞은 개찰구를 통과해 서로 다른 통로로 들어갑니다.

GLM Coding Plan을 구독해도 계정의 모든 키가 플랜 한도를 쓰는 것은 아닙니다. Z.ai에 따르면 2026년 10월 16일부터 만든 Standard 및 Coding Plan 키는 지원 엔드포인트 전반에서 키 유형으로 과금이 결정됩니다. 이전 Compatible 키에는 엔드포인트에 따라 달라지는 별도 규칙이 적용됩니다.

따라서 “한도가 남아 있다”는 사실과 잔액 차감 또는 요청 실패는 동시에 발생할 수 있습니다. 이 글은 경로·키 확인표, 오류 분류기, 통제된 검증 절차를 제공합니다. 2026년 11월 17일 확인한 공식 문서를 바탕으로 하며, 유료 계정 과금 실험을 실행하거나 독자의 계정을 확인한 것은 아닙니다.

GLM 사용 주제를 확장하는 글이며 GLM 5.5 출시 발표가 아닙니다. 오늘 확인한 공식 공개 색인에는 여전히 GLM-5.3 계열이 나옵니다. 이 문제는 GLM 5.5 출시 및 제공 여부 확인에서 따로 다룹니다. 작동 중인 설정에 추측한 glm-5.5 식별자를 넣지 마세요.

콘솔에서 키 유형 확인하기

Z.ai의 API 키 관리 가이드 (영문)를 참고해 실제 도구 프로세스에 설정된 키를 식별합니다. 비밀 문자열의 생김새가 아니라 콘솔 표시와 생성 경로를 확인하세요. 한 계정에 여러 유형의 키가 공존할 수 있습니다.

콘솔 키 유형생성 위치확인할 과금 규칙
Standard API KeyStandard API Key 생성 메뉴Coding Plan 한도가 아닌 계정 잔액 또는 적용 가능한 사용량 패키지
Personal Coding Plan API KeyPersonal Coding Plan 메뉴개인 플랜 한도
Team Plan KeyTeam Coding Plan → My Plan설정된 초과 사용 정책을 포함한 팀 플랜과 좌석 규칙
기존 Compatible 키이전 키의 자동 분류엔드포인트와 계정의 플랜 이력에 따라 동작 결정

10월 16일 공지에 따르면 분류가 바뀌었다는 이유만으로 기존 키 값을 교체할 필요는 없습니다. Team Plan 프로젝트에 연결된 이전 키는 Team Plan 키가 됩니다. Coding Plan을 이용한 이력이 있는 계정의 해당 개인 키는 Compatible로 분류됩니다. 그런 이력이 없는 이전 계정에는 Standard 분류가 적용됩니다. 별도 기업 계약이나 파트너 채널 예외는 계약된 동작을 유지할 수 있습니다.

문제 해결의 첫 단계로 모든 키를 교체하지 마세요. 먼저 어떤 키가 실제 사용되는지 파악합니다. 터미널 환경 변수, IDE 설정, 프로젝트 구성, 공급자 전환 도구가 여전히 오래된 인증 정보를 참조할 수 있습니다. 진단 메모에는 비밀이 아닌 콘솔 이름이나 내부 식별자만 남기세요. 전체 키를 문의 글이나 공개 스크린샷에 넣으면 안 됩니다.

올바른 엔드포인트 규칙 적용하기

새 Standard 및 Coding Plan 키는 지원 엔드포인트를 바꿔도 과금 유형이 바뀌지 않습니다. Claude Code에 넣은 Standard 키는 Coding Plan이 활성 상태이고 한도가 남아 있어도 API 잔액을 차감할 수 있습니다. 플랜 한도를 사용하려면 해당 플랜 키와 지원 도구 설정을 사용해야 합니다.

기존 Compatible 키에 대해 Z.ai 공지는 다음 경로별 동작을 안내합니다.

Base URL프로토콜·용도Compatible 키 동작
https://api.z.ai/api/paas/v4일반 Chat CompletionsCoding Plan 한도가 아닌 잔액 또는 적용 가능한 사용량 패키지
https://api.z.ai/api/coding/paas/v4Coding Plan Chat Completions플랜 이용 이력이 있으면 플랜 한도를 사용하며, 플랜 만료 시 호출 중단
https://api.z.ai/api/anthropicAnthropic Messages공식 Compatible 키 표의 동일한 플랜 이력 규칙
https://api.z.ai/api/v1OpenAI Responses공식 Compatible 키 표의 동일한 플랜 이력 규칙

공지에는 Coding Plan을 이용한 적 없는 계정은 뒤쪽 경로에서도 잔액이나 패키지로 과금된다는 설명이 있습니다. 콘솔 분류가 이 시나리오와 맞지 않으면 URL만으로 추정하지 말고 지원팀에 키 분류와 요청 기록을 대조해 달라고 요청하세요. 팀 초과 사용과 별도 기업 계약은 계정별로 확인해야 합니다.

이 주소는 Z.ai 경로입니다. BigModel 중국 서비스 계정이나 타사 공급자의 과금을 설명하지 않습니다. Ofox 키는 Z.ai 구독이 아니라 Ofox 인증 규칙을 따릅니다. 전환 전 Ofox 모델 제공 여부와 공급자별 문서를 확인하세요. 표의 URL을 Ofox 설정에 복사하지 마세요.

클라이언트에서 사용량 기록까지 요청 한 건 추적하기

아무것도 바꾸기 전에 작은 확인표를 만드세요.

Client and version:
Process actually launched (CLI / IDE / container):
Provider and Base URL:
Protocol (Messages / Chat Completions / Responses):
Exact model ID or alias mapping:
Key class shown in provider console (NO secret value):
Plan active? Remaining quota? Team overage enabled?:
Local timestamp and time zone:
HTTP status / business code / sanitized request ID:
Usage record and billing bucket after the test:

비교를 방해하지 않도록 관련 없는 시험 세션을 중지합니다. 해당 플랜 사용량과 잔액 화면을 기록한 뒤, 발생할 수 있는 비용을 허용하는 경우에만 민감 정보가 없는 작은 요청 한 건을 실행하세요. 예를 들어 도구나 저장소 접근 없이 설정된 모델에 READY 한 단어만 반환하도록 요청할 수 있습니다. 기본 호출 확인이며 품질 벤치마크는 아닙니다.

그다음 클라이언트 시각, 제공된다면 요청 식별자, 선택한 모델, 공급자의 사용량 항목을 대조합니다. 응답 성공만으로 어느 항목에서 비용이 나갔는지는 증명되지 않습니다. 대시보드 반영 지연을 고려하세요. 과금 출처가 여전히 불명확하면 유료 확인 요청을 연달아 만들지 말고 추가 실험을 멈춘 뒤 비밀 정보를 제거한 증거를 지원팀용으로 보관하세요.

다음 세 가지는 측정 결과가 아닌 설명용 사례입니다.

  • Claude Code의 새 Standard 키가 성공하고 일반 API 사용량에 기록됩니다. 플랜 한도가 남아 있어도 문서 규칙과 일치합니다.
  • 기존 Compatible 키가 일반 Chat Completions 엔드포인트에서 성공하고 잔액을 차감합니다. 이 이전 키는 경로만 바꿔도 과금 항목이 바뀔 수 있지만, 새 Standard 키까지 일반화할 수는 없습니다.
  • 플랜이 만료된 Compatible 키가 플랜 경로에서 실패합니다. 공지는 종량제로 자동 전환되지 않는다고 설명합니다. API 과금을 의도적으로 사용하려면 Standard 키를 만들고 충분한 잔액과 지원 엔드포인트로 이용하세요. 이는 무료 대체 경로가 아니라 과금 방식 선택입니다.

새로 만든 키라면 올바른 유형으로 바꾸고 실제 클라이언트 프로세스를 재시작한 뒤 통제된 확인 한 건을 반복합니다. Compatible 키라면 먼저 플랜 과금과 일반 API 과금 중 무엇을 원하는지 결정한 뒤 문서 규칙을 적용하세요. 키, 엔드포인트, 모델, 재시도 정책을 동시에 바꾸면 어떤 변경이 문제를 해결했는지 알 수 없게 됩니다.

429 안의 업무 오류 코드 읽기

Z.ai의 오류 코드 문서 (영문)는 서로 다른 여러 원인에 HTTP 429를 사용합니다. 일반적인 지수 백오프 반복문이 모든 원인의 해결책은 아닙니다.

업무 코드문서상 분류유용한 대응
1113잔액 또는 리소스 패키지 부족과금 항목과 자금을 확인하고 플랜 한도가 적용된다고 가정하지 않습니다
1302요청 속도 제한동시 실행을 줄이고 횟수가 제한된 백오프를 사용합니다
1305일시적 과부하제한된 정책으로 재시도하고 지속되는 실패를 기록합니다
1308, 1310사용량 기간 한도반환된 초기화 정보를 읽고 현지 자정에 초기화된다고 추정하지 않습니다
1309Coding Plan 만료상태를 확인하고 승인된 갱신 또는 의도적인 일반 API 경로를 선택합니다
1311플랜에 선택한 모델 권한 없음모델 이용 권한과 정확한 매핑을 확인합니다
1313공정 사용 제한공급자 지원 절차를 따릅니다. 키를 늘리는 것은 우회책이 아닙니다
1315기업 코딩 시나리오로 제한된 키적합한 제품 키와 계정 설정을 사용합니다
1316–1321사용량 기간과 추가 사용 잔액 또는 지출 한도 조건정확한 메시지를 읽고 지출 변경 전 초과 사용 자격과 설정 한도를 확인합니다

인증 오류는 별도로 다룹니다. 예를 들어 문서에서 1000과 1001은 HTTP 401에 연결됩니다. 한도를 늘려도 누락된 인증 헤더는 복구되지 않습니다. 반대로 유효한 키를 반복 교체한다고 만료된 플랜이 복원되지는 않습니다.

저장한 오류 응답을 로컬에서 분류하려면 아래를 classify_glm_error.py로 저장하세요. 표준 입력에서 JSON을 읽고 응답 메시지나 인증 정보 대신 코드와 진단 분류만 출력합니다.

import json
import sys

categories = {
    "1000": "authentication", "1001": "authentication",
    "1003": "authentication", "1005": "authentication",
    "1113": "billing-balance", "1302": "request-rate",
    "1305": "temporary-overload", "1308": "usage-window",
    "1309": "plan-expired", "1310": "usage-window",
    "1311": "model-entitlement", "1313": "fair-usage",
    "1314": "enterprise-plan-expired", "1315": "key-product-mismatch",
}
categories.update({str(n): "extra-usage-condition" for n in range(1316, 1322)})
data = json.load(sys.stdin)
error = data.get("error", {}) if isinstance(data, dict) else {}
code = str(error.get("code", "unknown")) if isinstance(error, dict) else "unknown"
print(json.dumps({"code": code, "category": categories.get(code, "inspect-provider-response")}))

합성 데이터를 이용한 로컬 확인:

printf '%s\n' '{"error":{"code":"1311","message":"synthetic example"}}' | python3 classify_glm_error.py

예상 분류는 model-entitlement입니다. 숫자 코드와 오류 객체가 없는 경우를 포함해 이 분류기를 로컬에서 시험했습니다. 네트워크 오류를 진단하거나 게이트웨이별 응답 형식을 통일하지 않으며, 공급자의 정확한 메시지를 읽는 과정을 대체하지 않습니다. 알 수 없다는 결과는 응답 구조를 확인하라는 뜻이지 요청 성공을 의미하지 않습니다. SSE 스트림이 비정상 종료될 때 Z.ai는 일반 오류 코드가 아니라 finish_reason에 예외 사유를 기록하도록 안내합니다. 스트리밍 이벤트를 별도로 저장하고 확인하세요. 이 JSON 분류기는 SSE를 해석하지 않습니다.

과금 수정 후 모델 선택 확인하기

키와 경로가 맞으면 정확한 모델 매핑을 별도로 검증합니다. 공식 모델 전환 가이드 (영문)는 현재 GLM-5.3과 GLM-5.3-Flash를 설명합니다. 구독 등급, Opus 같은 클라이언트 별칭, 공개 API 모델 식별자는 서로 다른 것입니다.

클라이언트가 모델이 없다고 하면 설정된 식별자와 프로토콜을 최신 공급자 문서와 비교하세요. OpenAI model-not-found 문제 해결 가이드 (영문)의 공급자·엔드포인트 확인 방법을 참고하면 이름 오류와 접근 불가를 구분하는 데 도움이 됩니다. Ofox 경로의 요청 속도를 조절할 때는 Ofox 속도 제한 문서를 사용하세요. 그 제한을 유추해서 Z.ai 계정에 적용하면 안 됩니다.

플랜이 작동하는지 시험하려고 추측한 GLM 5.5 모델 이름을 사용하지 마세요. 계정과 경로에서 명시적으로 제공되는 모델부터 시작합니다. 기본 호출과 과금 출처 확인이 통과한 다음 긴 에이전트 실행, 도구, 컨텍스트 확장을 시험하세요.

재시도 반복 대신 증거로 문제 종결하기

해결된 사례는 키 유형, 의도한 엔드포인트, 허용된 모델, 실제 과금 항목을 식별하고 수정된 설정에서 해당 오류가 사라졌음을 보여야 합니다. 비밀 정보를 다시 만들지 않고도 설정 변경을 되돌릴 수 있도록 이전 설정을 보관하세요.

공급자 기록이 문서 규칙과 충돌한다면 시간대가 포함된 시각, 비밀 정보를 제거한 요청 ID, 키 유형, 모델, 오류 코드를 지원팀에 전달하세요. 별도로 승인된 이유와 안전한 채널이 없다면 전체 인증 정보나 비공개 프롬프트 내용을 보내지 마세요. 또 다른 불확실한 요청 묶음을 만들지 않고 과금 조사를 진행할 수 있습니다.

자주 묻는 질문

Base URL을 바꾸면 새 Standard 키가 Coding Plan 한도를 사용하나요?
아니요. Z.ai에 따르면 2026년 10월 16일부터 생성한 Standard 또는 Coding Plan 키는 지원 엔드포인트 전반에서 키 유형으로 과금이 결정됩니다. 기존 Compatible 키에는 다른 규칙이 적용됩니다.
GLM HTTP 429는 모두 기다렸다가 재시도하면 되나요?
아니요. 공급자의 업무 오류 코드는 잔액, 사용 한도, 플랜 만료, 모델 권한 또는 요청 속도 제한을 뜻할 수 있습니다. 재시도 전에 해당 원인부터 해결하세요.