가장 흔한 원인: 사전 승인 금액이 잔액을 초과
요청을 실행하기 전에 LaoZhang API는 모델 가격, 입력 크기, 예상 출력으로 이 요청이 최대 얼마까지 들 수 있는지 추정해 그 금액을 잔액에서 미리 확보합니다. 요청이 끝나면 실제 사용량대로 정산하고 남은 금액은 돌려줍니다.- 잔액이 확보할 금액보다 크면 요청이 진행됩니다.
- 부족하면 요청이 실행되기 전에
insufficient_user_quota로 거부됩니다. 모델은 호출되지 않고 과금도 없습니다.
quota는 현재 사용할 수 있는 잔액입니다.preConsumedQuota는 이 요청이 확보해야 하는 금액입니다.- 둘 다 내부 quota 단위이며 500,000이 약 $1입니다. 이 예에서는 잔액이 약 $100, 확보할 금액이 약 $300이라 요청이 거부됩니다.
- 입력을 작업에 실제로 필요한 코드, 문서, 대화 기록으로 줄입니다.
- 출력 한도를 명시해 예상 출력을 낮춥니다. max_tokens를 참고하세요.
- 큰 입력이 꼭 필요하다면 잔액이 확보 금액을 넘도록 충전합니다. 결제 수단을 참고하세요.
토큰에도 자체 quota가 있습니다.
- 토큰을 만들 때 무제한 quota를 끄면, 계정에 돈이 남아 있어도 그 토큰의 quota가 소진되는 순간 요청이 거부됩니다.
- 토큰 관리에서 해당 토큰을 편집해 quota를 늘리세요. 새 키는 필요 없습니다.
점검 순서
1. 실제 오류 기록
클라이언트가 보여 주는 일반적인 “잔액 부족” 메시지만으로 판단하지 마세요. 오류 본문에insufficient_user_quota가 있으면 위 절부터 확인합니다. 다음을 기록하세요.
- 요청 시각과 시간대
- 모델 ID와 엔드포인트
- API 키 그룹
- HTTP 상태와 플랫폼 오류
- 요청에서 사용량이나 과금이 발생했는지 여부
2. 현재 가격과 과금 단위 확인
콘솔 가격 페이지를 열어 대상 모델이 토큰, 요청, 이미지, 비디오 길이 등 어떤 단위로 과금되는지 확인하세요. 업스트림 제공사의 가격이나 오래된 정적 문서 표로 청구액을 예측하지 마세요.3. 입력 크기 줄이기
긴 컨텍스트, 여러 이미지, 큰 파일, PDF, 비디오, 큰 출력 한도는 추정 사용량을 늘릴 수 있습니다. 최소한의 입력으로 다시 시도해 보세요.- 짧은 메시지 하나만 보냅니다.
- 이미지, 파일, 도구 호출을 일시적으로 뺍니다.
- 더 작은 출력 한도를 명시합니다.
- 진단이 되도록 다른 조건은 그대로 둡니다.
4. 그룹, 권한, 엔드포인트 확인
같은 모델 이름도 API 키 그룹, 과금 유형, 엔드포인트에 따라 다른 경로를 탈 수 있습니다. 다음을 확인하세요.- 키가 대상 모델과 과금 방식을 허용하는지
- 엔드포인트가 현재 문서와 일치하는지
- 모델 ID가 정확한지
- 사이트 관리자나 고객 지원이 권한을 조정해야 하는 계정은 아닌지
5. 플랫폼 오류와 업스트림 오류 구분
최소 요청도 실패한다면 속도 제한, 안전 정책 차단, 업스트림 장애, 타임아웃, 일시적인 라우팅 문제를 확인하세요. 무한정 재시도하지 마세요. 재시도할 수 없는 오류는 파라미터, 권한, 잔액을 고치고, 일시적인 오류는 횟수를 제한한 백오프로 재시도합니다.고객 지원에 보낼 정보
- 계정 이메일 또는 사용자 이름
- 요청 시각과 시간대
- 모델 ID, 엔드포인트, API 키 그룹
- 민감 정보를 가린 오류와 요청 식별자
- 콘솔 잔액 화면과 가격 페이지 스크린샷
- 최소 재현 결과