GLM API 키: 문제 해결 가이드

키가 'Unauthorized'를 반환하는 이유

'Unauthorized' 오류는 일반적으로 구성된 API 키와 base URL 엔드포인트 간의 불일치에서 비롯됩니다. Zed 또는 Trae와 같은 편집기에 새로운 LLM을 통합할 때 base URL이 일반 프록시가 아닌 제공업체의 채팅 완료 엔드포인트를 직접 가리키는지 확인해야 합니다. OpenAI 호환 클라이언트를 사용하는 경우 당사 서비스의 base URL은 HTTPS://api.apiglm.com/v1입니다. 잘못된 URL이나 만료된 키를 입력하면 즉시 401 응답이 발생합니다.

가장 흔한 원인 중 하나는 키를 잘못된 헤더 형식으로 전송하는 것입니다. 일부 클라이언트는 'Authorization: Bearer '를 기대하는 반면, 다른 클라이언트는 입력 필드를 잘못 해석할 수 있습니다. Google 또는 이메일로 로그인한 후 대시보드에 표시된 대로 키가 정확히 복사되었는지 확인하세요. 전화번호 확인 단계가 없으므로 키가 유효하다면 모든 표준 OpenAI SDK 구현에서 작동해야 합니다.

• 베이스 URL이 /v1로 끝나는지 확인하세요.
• URL 문자열에 후행 슬래시가 없어야 합니다.
• 키가 취소되거나 교체되지 않았는지 확인하십시오.

'Thinking Block' 문제 처리

추론 중점 모델 사용자들은 종종 모델이 태그만 출력하고 텍스트는 출력하지 않는 빈 '생각' 블록을 마주합니다. 이는 항상 코드 버그가 아니라 하위_uncensored_ 모델 아키텍처의 동작입니다. 모델은 공백이나 null 문자만 포함된 추론 블록을 출력할 수 있으며, 이는 파서가 빈 응답으로 해석할 수 있습니다.

이 문제를 처리하려면 클라이언트를 구성하여 빈 reasoning 태그를 무시하거나 처리 전에 공백을 제거하세요. 사용자 정의 reasoning transformer를 사용하는 경우 이러한 예외 상황을 올바르게 처리하는지 확인하세요. 모델은 직접적인 답변에 맞게 조정되므로 과도한 사고 블록은 때때로 'temperature' 또는 'top_p' 매개변수를 조정하여 더 직접적인 응답을 유도해야 함을 나타낼 수 있습니다.

이것을 디버깅하려면 원본 응답 바이트를 로깅해야 합니다. 사고 블록이 있지만 비어 있다면 건너뛰고 실제 콘텐츠 생성으로 진행해도 안전합니다. 이렇게 하면 애플리케이션이 존재하지 않는 텍스트를 기다리며 멈추지 않도록 보장합니다.

편집기에서 베이스 URL 구성

Zed나 Claude Code와 같은 로컬 편집기에 uncensored LLM을 통합하려면 기본 환경 변수를 재정의해야 합니다. 대부분의 편집기는 기본값으로 OpenAI의 base URL을 사용합니다. 구성 파일에서 base URL을 명시적으로 HTTPS://api.apiglm.com/v1로 설정해야 합니다.

For .env.development or config.js files, ensure the API key variable is correctly mapped. For example, set the base URL variable to point to our endpoint. This ensures that all requests, including function calling and streaming, route through our infrastructure. If the editor does not support custom base URLs, you may need to use a proxy or a wrapper script that translates the standard OpenAI protocol to our endpoint.

간단한 'ping' 요청을 보내어 통합되었는지 확인하십시오. 유효한 JSON 응답을 받으면 구성이 올바릅니다. 복잡한 다중 턴 대화 시도 전에 이 단계가 중요합니다.

속도 제한 및 동시성 오류

인프라는 고부하 사용 중 안정성을 보장하기 위해 엄격한 속도 제한을 시행합니다. 각 API 키는 분당 300개의 요청으로 제한되며 최대 8개의 동시 요청을 처리할 수 있습니다. 이러한 제한을 초과하면 429 Too Many Requests 오류가 발생합니다.

이러한 오류를 피하려면 클라이언트 코드에 지수 백오프를 구현하세요. 사용 가능한 경우 응답의 'Retry-After' 헤드를 모니터링하세요. 또한 피크 시간대에 트래픽이 급증하지 않도록 애플리케이션을 확인하세요. 여러 인스턴스를 실행 중인 경우 부하를 다른 키에 분산하거나 애플리케이션 수준에서 동시성을 관리하세요.

요청 본문 크기도 8 MB로 제한됩니다. 큰 프롬프트나 많은 도구 호출은 이 한계를 초과할 수 있습니다. 입력을 분할하거나 동시 요청 수를 줄여 이러한 한계 내에 머무르십시오. 이러한 한계는 투명하며 자원 고갈을 방지하도록 설계되었습니다.

토큰 세기 및 컨텍스트 윈도우

토큰 사용량은 비용 관리에 중요합니다. 당사 모델은 프롬프트와 완성문을 모두 포함하여 100,000개의 토큰 컨텍스트 윈도우를 지원합니다. 요청당 최대 출력은 16,000토큰이며, 'max_tokens'을 지정하지 않을 경우 2,048토큰입니다.

가격은 실제 토큰 사용량을 기준으로 책정됩니다: 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 오류 및 거부 요청은 무료이므로 성공적인 콘텐츠 생성에 대해서만 요금이 부과됩니다. 이 선불 모델은 크레딧이 만료되지 않으며, 언제든지 암호화폐로 충전할 수 있음을 의미합니다.

응답 메타데이터를 파싱하여 애플리케이션에서 토큰 사용량을 추적하세요. 스트리밍 응답의 마지막 청크에는 총 토큰 수가 포함되어 있습니다. 이를 통해 실시간으로 비용을 모니터링하고 프롬프트를 조정하여 예산 한도 내에서 유지할 수 있습니다. 효율적인 토큰 사용은 선불 크레딧의 가치를 극대화하는 핵심입니다.

스트리밍 응답 파싱

스트리밍 응답은 Server-Sent Events(SSE)를 통해 제공됩니다. 각 청크에는 응답의 일부가 포함되지만 토큰 사용량 데이터는 마지막 청크에만 포함됩니다. 이는 스트림이 완료될 때까지 총 토큰 사용량을 계산할 수 없음을 의미합니다.

'data' 이벤트를 수신하여 스트림을 파싱하세요. 텍스트 청크를 누적하여 전체 응답을 구성하세요. 마지막 청크를 받으면 'usage' 필드를 추출하여 로컬 토큰 카운터를 업데이트하세요. 이 접근 방식은 정확한 청구를 보장하고 리소스 소비를 모니터링하는 데 도움이 됩니다.

네트워크 중단 사항을 우아하게 처리하세요. 스트림이 끊기면 요청을 재시도해야 할 수 있습니다. 클라이언트가 부분 응답을 처리하고 올바르게 재조립할 수 있도록 하세요. 스트리밍은 실시간 애플리케이션에 이상적이지만 견고한 오류 처리가 필요합니다.

함수 호출 매개변수 오류

함수 호출은 정밀한 파라미터 구성이 필요합니다. 'tools' 배열이 매개변수 및 설명을 포함하는 함수 스키마를 올바르게 정의하는지 확인하세요. 'tool_choice' 파라미터는 'auto', 'required' 또는 특정 함수 이름으로 설정할 수 있습니다.

자주 발생하는 오류에는 도구 스키마의 필수 필드 누락 또는 잘못된 데이터 유형이 포함됩니다. 구조화된 출력을 기대하는 경우 클라이언트가 'response_format'을 'json_object'로 전송하는지 확인하십시오. 이렇게 하면 모델이 애플리케이션에서 구문 분석할 수 있는 유효한 JSON을 반환합니다.

먼저 간단한 도구로 함수 호출을 테스트하세요. 복잡도를 점진적으로 높여 스키마 불일치를 식별합니다. 모델이 도구를 호출하지 않으면 응답의 'tool_calls' 필드에서 오류를 확인하세요. 신뢰할 수 있는 함수 호출을 위해 적절한 구성이 필수적입니다.

암호화폐 충전 지연 해결

크레딧 충전은 암호화폐, 구체적으로 USDT(TRC20) 또는 USDC(Base)를 통해 이루어집니다. 거래는 블록체인에서 확인하는 데 몇 분이 걸릴 수 있습니다. 크레딧이 즉시 표시되지 않으면 네트워크 확인을 기다리세요.

보너스 크레딧은 $50 이상의 충전 시 자동으로 적용됩니다: $50 충전 시 +5%, $100 충전 시 +10%, $200 충전 시 +15%. 정확한 금액을 전송하여 적절한 보너스를 받으세요. $20 미만 또는 $500 이상의 거래는 보너스 적용이 없거나 거절될 수 있습니다.

이중 청구가 발생하면 지원 페이지를 통해 지원팀에 연락하세요. 크레딧은 환불되지 않지만 조정될 수 있습니다. 더 빠른 해결을 위해 거래 ID 기록을 보관하세요. 이 선불 모델은 만료로 인해 크레딧이 손실되지 않도록 보장합니다.

모델 ID 오구성

잘못된 모델 ID를 사용하는 것은 오류의 빈번한 원인입니다. 당사 무검열 모델의 ID는 단순히 'uncensored'입니다. 'gpt-4' 또는 'claude-3'으로 요청을 보내면 'Model Not Found' 오류가 발생합니다.

클라이언트가 'uncensored'를 'model' 필드에 명시적으로 설정하는지 확인하세요. 이는 다른 모델을 기본값으로 사용할 수 있는 OpenAI 호환 SDK를 사용할 때 중요합니다. 구성 파일 및 테스트 요청에서 모델 ID를 확인하세요.

당사 서비스는 모델 라우팅이나 다중 모델 선택을 제공하지 않습니다. 이는 무검열 텍스트 생성 전용 단일 모델 엔드포인트입니다. 이 단순성은 복잡성을 줄이고 일관된 성능을 보장합니다. 프로덕션에 배포하기 전에 모델 ID를 항상 다시 확인하세요.