심층 해설 · 약 3분 읽기
Z.ai, 새 Coding Plan 키와 표준 API 키 분리: 과금 유형이 중요한 이유
10월 16일 가이드는 새 유형 키와 엔드포인트 영향을 받는 기존 Compatible 키를 구분한다.
- 사이트 게시일
- 원문 게시일
- 출처 확인일
Z.ai의 10월 16일 API 키 관리 가이드는 새 표준 API 자격 증명과 GLM Coding Plan 자격 증명을 분리한다. 이번 변경 때문에 기존 키 값을 바꿀 필요는 없다. 과금을 판단하려면 새 유형 키인지, 기존 동작을 유지하는 Compatible 키인지 먼저 구분해야 한다.
뉴스 듣기
이 기사를 읽어 드리거나 뉴스를 계속 재생합니다.
읽기를 준비하는 중…
기기 음성
읽기는 브라우저나 기기에서 처리합니다. AISubHub는 내용을 오디오 API로 보내지 않습니다. 사용 가능한 음성과 잠금 화면 재생은 기기에 따라 다릅니다.
계속 재생할 때 짧은 구절이 반복될 수 있습니다.
핵심 요약
- 10월 16일부터 만든 Standard API Key는 잔액이나 적용 가능한 사용 패키지를 쓴다. 개인·팀 Coding Plan 키는 지원 엔드포인트에서 해당 플랜을 쓴다.
- 기존 Compatible 키는 이전 규칙을 유지한다. 표준 API 엔드포인트는 표준 과금이며, 플랜 엔드포인트는 Coding Plan 구독 이력에도 좌우된다. 만료가 자동 종량제 전환을 뜻하지 않는다.
새 키는 과금 방식을 명시적으로 선택한다
생성 경로는 세 가지다. Standard API Key는 종량제나 사용 패키지용이다. 개인은 API Keys → Personal Coding Plan, 팀은 Team Coding Plan → My Plan에서 키를 얻으며 팀·좌석 규칙을 따른다. 10월 16일 이후의 Standard 및 Coding Plan 키는 지원 엔드포인트에서도 키 유형이 과금을 결정한다. Base URL을 바꿔도 표준 키가 구독 한도로 바뀌지 않는다. 다른 도구의 작동하는 구성을 복사하면 요청은 성공해도 예상과 다른 잔액을 쓸 수 있다. 구독이 무제한 범용 API 권리로 바뀌었다거나 가격·한도가 개선됐다는 발표가 아니다.
기존 키는 값을 바꾸지 않고 이력에 따라 분류
10월 16일 이전 키는 별도로 처리한다. Team Plan 프로젝트 키는 팀 키가 된다. 팀 프로젝트 밖에서는 Coding Plan을 구매했거나 활성 구독을 가졌던 이력이 있는 계정의 키가 Compatible이며, 그런 이력이 전혀 없는 계정은 표준이다. 과거 이력이 중요하며 오늘 활성 구독 여부만으로 정하지 않는다. 키 값은 유지되므로 분류 변경 때문에 기존 도구를 재설정할 필요는 없다. 일부 전용 기업·파트너 키는 종전 호환 동작을 유지하며 콘솔 분류와 서비스 계약이 기준이다. 따라서 모든 키를 일괄 교체하라는 조언은 공지와 다르다.
Compatible에는 엔드포인트별 경계가 남는다
기존 Compatible 키로 표준 Chat Completions인 https://api.z.ai/api/paas/v4를 호출하면 구독 한도가 아니라 잔액이나 패키지를 쓴다. https://api.z.ai/api/coding/paas/v4에서는 Coding Plan 이력이 있는 계정이 플랜 한도를 쓰며 만료 후 호출은 중지된다. 이력이 없으면 표준 과금으로 설명한다. 표에는 일반 Anthropic Messages와 OpenAI Responses 경로의 호환 규칙도 있다. 같은 구형 키로 coding에서는 구독을, 표준에서는 잔액을 쓸 수 있으며 구독 한도가 남아도 후자가 과금될 수 있다. 이를 새 유형 키 전체에 일반화해서는 안 된다.
유료 설정을 바꾸기 전에 분류부터 확인
AISubHub 분석: 콘솔의 키 분류를 먼저 확인하고 엔드포인트와 원하는 과금 자원을 대조한 뒤 플랜이 유효한지 본다. 키 목록 위치, 구독 영수증, 성공 응답만으로는 부족하다. 플랜 경로의 Compatible은 만료 후 자동 종량제가 되지 않는다. 가이드는 Standard API Key를 만들어 설정하고 잔액이나 패키지를 준비하라고 안내하며 엔드포인트는 유지할 수 있다. 팀의 주문형 초과 사용이 켜져 있다면 기존 설정과 규칙을 따른다. 이는 문서상 절차이지 당사의 실측이 아니다. 스크린샷이나 문제 보고에 완전한 키를 노출하지 않아야 한다.
중요한 이유
AISubHub 분석: 구독과 API 잔액이 함께 있어도 요청이 더 저렴한 쪽을 자동 선택하지 않는다. 키 분류, 엔드포인트, 플랜 상태를 함께 확인해야 한다. 응답 성공만으로 어떤 잔액을 썼는지는 알 수 없다.
제한 및 이용 가능성
공식 가이드를 전체 읽었지만 로그인, 키 생성, 개인 청구서 열람, API 호출은 하지 않았다. 새 GLM 모델이나 가격 인하가 아닌 과금 관리 변경이다. 지원 도구, 한도와 계약도 적용된다.
출처와 근거
원문 게시일: · 출처 확인일:
AI 보조 편집 기사를 명시한 일차 출처와 대조합니다. 업체 주장은 출처를 밝히며 게재는 추천을 뜻하지 않습니다.