자주 발생하는 오류 해결

실패한 요청은 대부분 다음 다섯 가지 경우에 해당합니다. 표시된 메시지에 맞춰 처리하면 보통 지원팀에 문의할 필요가 없습니다.

`Invalid key! Your api-key is invalid or expired` (401)

요청은 당사에 도달했지만 키가 승인되지 않았습니다.

복사할 때 앞뒤 공백이 포함된 경우 — API Keys에서 다시 복사하세요.
키가 삭제되었거나 만료된 경우 — 새 키를 만드세요.
CLI가 예상과 다른 키를 읽고 있는 경우: claude /status, opencode auth list 같은 확인 명령을 사용하거나 내보낸 환경 변수를 출력해 확인하세요.

거의 항상 base URL 끝에 /v1이 붙어 있기 때문입니다. 엔드포인트는 여기서 끝납니다.

1 https://www.codebyai.net/api/agent

https://www.codebyai.net/api/agent/v1/chat/completions는 그대로 업스트림으로 전달되어 404가 됩니다. base URL에서 /v1을 제거하고 경로 결합은 SDK에 맡기세요.

채팅 엔드포인트는 해당 프로토콜에 속한 모델만 처리합니다.

모델 플라자에서 정확한 모델 id를 확인하세요. 업스트림에 없는 id는 조용히 다른 모델로 대체되지 않고 오류를 반환합니다.

키는 정상이고 잔액이 비어 있습니다. 지갑에서 충전하세요. 절차는 충전과 잔액에 정리되어 있습니다.

제한 지역에서 온 요청은 엣지에서 거부됩니다. 오판이라고 판단되는 경우 (예: 회사 VPN의 출구가 다른 국가인 경우) 연결에 사용한 공인 IP와 함께 문의해 주세요.

실패한 요청의 상태 코드, 모델 id, 사용 중인 도구 이름과 버전을 cfjwlchangji@gmail.com으로 보내 주세요. 보통 그것만으로 원인을 특정할 수 있습니다.