문제 해결
이 페이지의 내용
현재 겪고 있는 증상에 해당하는 항목을 따라 진행하십시오. 거의 모든 경우 Logs 탭이 가장 빠른 진단 도구입니다. 각 요청의 상태와 실패 패턴(특정 키 하나인지, 특정 모델 하나인지, 전체인지)을 보여 줍니다. 활동 및 로그를 참조하십시오.
요청이 차단됨
모든 요청이 402 insufficient_credits로 실패함
원인: 이 시설에서 모듈이 활성화되지 않았거나 선불 잔액이 소진되었습니다(Overview 탭에 *"Your balance is depleted. Inference requests will be blocked until you top up."*이 표시됨). API 키의 경우 Model Router가 활성화되지 않은 시설에서는 대신 403 *"Model Router is not enabled for this facility"*가 반환됩니다.
해결 방법: Welcome to Model Router 페이지에서 Model Router를 활성화한 다음(시작하기 참조) Budgets & Limits → Balance & Top-up에서 충전하십시오. 잔액이 입금되면 곧바로 요청이 재개됩니다. 재발을 방지하려면 자동 충전을 활성화하십시오. 예산 및 충전을 참조하십시오.
요청이 402 budget_exceeded로 실패함
원인: 지출 한도에 도달했습니다. 오류 메시지에는 어느 기간(일별/월별/전체 기간)인지와, 일별 및 월별의 경우 시설 시간대 기준으로 정확히 언제 재설정되는지가 표시됩니다. 계정 전체 한도일 수도 있고 특정 키나 연결된 서비스의 한도일 수도 있습니다(범위가 지정된 경우 메시지에 "This key's" / *"This agent's"*라고 표시됨).
해결 방법: 안내된 재설정 시점까지 기다리거나, 한도를 올리거나(Budgets & Limits → Spend Limits 또는 키나 서비스의 구성), 전체 기간 하드 캡의 경우 Reset hard cap을 사용하십시오. Spend Limits 페이지에서 어떤 한도가 "Limit reached" 상태인지 정확히 확인할 수 있습니다.
요청이 403 content_policy_violation으로 실패함
원인: 프롬프트가 block 모드 콘텐츠 필터 또는 프롬프트 인젝션 방어에 걸렸습니다.
해결 방법: 설정 → Guardrails를 검토하십시오. 특정 통합에 정당하게 다른 규칙이 필요하다면 시설 전체 정책을 완화하는 대신 해당 통합의 Override facility guardrails 토글을 사용하십시오. 가드레일을 참조하십시오.
요청이 429로 실패함
원인: 키 또는 연결된 서비스가 Requests / min 또는 Tokens / min 속도 제한을 초과했습니다.
해결 방법: 잠시 기다렸다가 다시 시도하거나, 키 또는 서비스 구성에서 속도 제한을 올리십시오(비워 두면 무제한). API 키를 참조하십시오.
특정 모델만 오류를 반환하고 다른 모델은 정상 작동함
원인: 해당 모델이 시설에서 비활성화되었거나, 키의 모델 제한에서 제외되었거나, 제공업체에 문제가 있을 수 있습니다.
해결 방법: 설정 → Models(활성화되어 있습니까?), 키의 Restrict models 목록, 그리고 Activity → Performance → Reliability & performance by model에서 시간에 따른 해당 모델의 오류율을 확인하십시오.
API 키 문제
401 Unauthorized
원인: 코드가 invalid_api_key("Missing or invalid API key")인 경우 Authorization: Bearer … 헤더가 없거나 형식이 잘못되었습니다. 코드가 없는 경우("Invalid API key") 알 수 없는 키(잘못 입력했거나 rotate 후의 이전 시크릿)이거나 revoked 상태인 키입니다.
해결 방법: 헤더 형식을 확인하고, 설정 → Service Access & API Keys에서 키의 상태를 확인하십시오. 취소된 키는 다시 활성화하고, 키가 교체된 경우 서비스를 새 시크릿으로 업데이트하십시오.
키 시크릿을 잃어버림
시크릿은 생성 시 한 번만 표시되며 복구할 수 없습니다. Rotate를 사용하십시오. 새 시크릿이 발급되며(한 번만 표시됨) 키의 레이블, 한도, 기록은 그대로 유지됩니다. 해당 키를 사용하는 모든 서비스를 업데이트하십시오: "You will need to reconfigure any services still using the old key."
키는 작동하지만 사용량이 잘못된 이름으로 표시됨
Activity와 Logs에서 키는 Label로 식별됩니다. 키를 편집하여 의미 있는 레이블을 지정하고, 하나의 키를 공유하지 말고 시스템마다 별도의 키를 부여하십시오.
에이전트 문제
에이전트가 Offline으로 표시됨
원인: 기기의 전원이 꺼져 있거나 연결이 끊겼습니다. 이는 기기 연결 문제이며 Model Router 설정 문제가 아닙니다.
해결 방법: 기기의 전원과 네트워크를 확인하십시오. 접근 구성은 영향을 받지 않으며 기기가 다시 연결되는 즉시 다시 작동합니다.
에이전트가 AI 요청에 응답하지 않음
다음 순서로 확인하십시오.
- 잔액: 잔액이 소진되면 모든 에이전트가 차단됩니다(에이전트에 크레딧 필요 상태가 표시됨). 충전하십시오.
- 서비스별 한도: 설정 → Service Access & API Keys → Connected Services에서 에이전트에 *"Limit reached"*가 표시됩니까? 한도를 올리거나 재설정될 때까지 기다리십시오.
- 계정 한도: Budgets & Limits → Spend Limits.
- 로그: 에이전트로 필터링하여 해당 요청의 실제 오류를 확인하십시오.
잔액 및 청구 관련 질문
지출 수치가 늦게 반영되는 것 같음
Available balance 및 Spent today 수치는 실시간입니다. Monthly usage는 15분마다 잔액과 대조되므로 아주 최근의 지출은 표시되기까지 몇 분이 걸릴 수 있습니다. 거래 내역에는 충전과 잔액 조정만 표시되므로 사용량은 거래 내역에 나타나지 않습니다.
자동 충전이 실행되지 않음
Balance & Top-up 페이지에서 등록된 카드 없음, 카드 인증 필요, 카드 거절 등의 배너가 있는지 확인하십시오. 카드 문제를 해결하거나(Update card / Edit payment details) 수동으로 충전하십시오. 자동 충전 확인은 약 15분마다 실행되므로 방금 임계값을 넘은 경우 실행되기까지 몇 분이 걸릴 수 있습니다.
충전에 실패함
"Additional card authentication is required. Please try again.": 다시 시도하십시오. 은행에서 인증을 요청할 수 있습니다. "Top-up could not be completed.": 결제가 거절되었습니다. 카드를 확인하거나 다른 금액으로 시도하십시오. 결제가 성공하지 않으면 크레딧이 적용되지 않습니다.
결제되었지만 잔액이 변하지 않음
충전은 즉시 입금됩니다. 페이지를 새로 고치십시오. 그래도 결제 성공이 잔액에 반영되지 않으면 거래 세부 정보 창(또는 카드 명세서)에서 Transaction ID와 Payment reference를 기록한 다음 지원 요청을 제기하십시오.
로그 및 분석 관련 질문
방금 보낸 요청이 아직 Logs에 없음
Live 새로 고침을 켜십시오(또는 Refresh now를 클릭하십시오). 요청은 보통 곧바로 표시되지만 부하가 많을 때는 조금 더 걸릴 수 있습니다.
요청하지 않은 모델이 로그에 표시됨
model: "auto"를 보낸 경우 로그에는 Auto Router가 최종 선택한 모델이 표시됩니다. 요청의 세부 정보를 열면 Requested model: auto를 확인할 수 있습니다. 이는 정상적인 동작입니다. 모델을 참조하십시오.
행에 "No charge"가 표시됨
비용이 발생하지 않은 실패 응답이나 빈 응답에는 No charge 배지가 붙습니다. 완전성을 위해 기록되지만 잔액을 소비하지는 않습니다.
CSV 내보내기가 예상보다 작음
원시 데이터 내보내기는 25,000행으로 제한됩니다. 날짜 범위를 좁히거나 요약 내보내기를 사용하십시오. 참고: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."