에러 코드

화면에 뜬 코드를 찾아 무슨 뜻이고 무엇을 하면 되는지 확인한다.

에러 응답은 항상 이 모양이다.

{ "error": { "code": "insufficient_credit", "message": "…", "detail": { } } }

code는 프로그램이 읽는 값이고 message는 사람이 읽는 값이다. 자동화 테스트에서는 code로 단언한다. 메시지 문구는 다듬어질 수 있지만 코드는 유지된다.

인증·계정

코드	뜻	조치
`no_capacity`	가용 노드 없음	노드 추가 요청을 보내거나 기다린다
`node_busy`	그 노드를 다른 세션이 씀	다른 노드를 쓴다
`node_disabled`	노드가 비활성 상태	Super Admin이 활성화해야 한다
`node_unregistered`	노드가 풀에서 해제됨	다른 노드로 시작한다
`session_exists`	이미 실행 중인 세션	중지 후 다시 시작한다
`not_stopped`	중지 상태가 아님	먼저 중지한다
`not_running`	실행 중이 아님	상태를 확인한다
`type_not_allowed`	팀에 허용되지 않은 유형	Org Admin에게 허용을 요청한다
`requires_reservation`	서버급 유형은 예약이 필요	`GPU 예약`에서 신청한다
`reservation_managed`	예약이 관리하는 인스턴스	자동 중지 시각은 예약 종료 시각으로 고정된다
`reserved_immutable`	예약 인스턴스는 유형 변경 불가	새 예약을 신청한다
`no_ec2_mapping`	유형에 EC2 타입 매핑 없음	Super Admin이 단가표에서 설정해야 한다
`modify_type_failed`	프로바이더가 유형 변경을 거부	메시지의 원인을 확인한다
`temporal_unavailable`	워크플로우 엔진 응답 없음 (503). 인스턴스 중지 경로에서만 난다	잠시 후 다시 시도한다. 세션은 계속 과금되니 반드시 재시도한다

코드	뜻	조치
`no_node`	노드에 바인딩되지 않은 인스턴스	노드가 배정된 뒤 관리할 수 있다
`sg_error`	프로바이더가 규칙 변경을 거부	메시지의 원인을 확인한다

코드	뜻	조치
`ack_required`	선불·취소 불가 동의 없음	동의 체크박스를 누른다
`invalid_duration`	기간 규칙 위반	1~14일, 또는 7일 배수로 최대 182일
`instant_type`	즉시 유형은 예약 대상이 아님	바로 실행한다
`cancellation_not_allowed`	승인된 예약은 취소 불가	조건 변경이 필요하면 운영에 문의한다
`not_adjusted`	조정안이 없음	상태를 확인한다
`not_pending`	승인 대기 상태가 아님	이미 처리된 건이다
`no_workflow`	예약 워크플로우를 찾을 수 없음. Temporal 순단도 여기로 온다	잠시 후 다시 시도하고, 계속되면 운영에 문의한다
`reservations_open`	진행 중 예약이 남음	승인 처리하거나 정리한다
`org_mismatch`	요청 조직과 등록 조직이 다름	맞는 조직의 노드로 채운다
`already_decided`	이미 처리된 요청	목록을 새로고침한다

코드	HTTP	뜻	조치
`invalid_api_key`	401	폐기됐거나 없는 키	새 키를 발급받는다
`team_locked`	403	팀이 잠김	예산을 증액해 잠금을 해제한다
`budget_exceeded`	429	키 예산 소진	Org Admin에게 증액을 요청한다
`model_not_found`	404	접근 없는 모델 또는 단가 미등록	모델 접근을 요청한다
`rate_limit_exceeded`	429	RPM·TPM 초과	호출 속도를 줄인다
`no_pending_key`	404	수령 대기 중인 키가 없음	Org Admin이 먼저 발급해야 한다
`already_revoked`	409	이미 폐기된 키	목록을 새로고침한다
`alias_budget_mismatch`	409	같은 이름 키가 다른 예산으로 존재	폐기 후 재발급하거나 수정한다
`key_create_conflict`	409	동시 생성 경합	잠시 후 다시 시도한다
`upstream_error` · `litellm_error`	502	LLM 업스트림 오류	잠시 후 다시 시도한다. 예산은 차감되지 않는다
`no_active_key`	409	활성 키가 없음	키를 먼저 발급·수령한다

일반 사용에서는 보이지 않는다. 보이면 운영에 알린다.

no_capacity와 예약 즉시 실행에서만 나온다. 서버급 예약은 가용과 무관하게 신청되므로 이 코드로 막히지 않는다.

insufficient_credit과 자동 반려 예약 승인 시 크레딧이 부족하면 API 오류가 아니라 예약이 자동 반려된다. 팀과 운영 양쪽에 알림이 간다.

team_locked와 member_deactivated 전자는 팀 전체가 크레딧 소진으로 막힌 것이고, 후자는 그 계정만 막힌 것이다.

already_revoked와 invalid_api_key 전자는 관리 API에서 폐기된 키를 다시 다룰 때, 후자는 게이트웨이에서 폐기된 키로 호출할 때다.