본문으로 건너뛰기

Advanced AI Space 문제 해결

Advanced AI Space 사용 중 발생할 수 있는 문제와 해결 방법을 안내합니다.

API 키로 엔드포인트를 호출할 수 없는 경우​

다음 항목을 순서대로 확인하세요.

  1. 엔드포인트 상태가 Active인지 확인합니다.
  2. API 키의 만료 일시를 확인합니다. API 키의 유효기간은 생성일로부터 370일입니다.
  3. 인증 정보 > API 키 > 엔드포인트 설정에서 호출 대상 엔드포인트가 API 키에 연결되어 있는지 확인합니다.
  4. 엔드포인트 상세 화면의 URL을 사용했는지 확인합니다.
  5. 엔드포인트의 로그 조회 탭에서 요청 처리 로그를 확인합니다.

엔드포인트에 연결되지 않은 API 키는 호출에 사용할 수 없습니다.

API 제한으로 요청이 거부되는 경우​

  1. 엔드포인트 상세 화면의 Request/토큰 사용량 탭으로 이동합니다.
  2. 호출에 사용한 API 키와 적용된 Tier를 확인합니다.
  3. 전체 요청, 입력 토큰 또는 출력 토큰의 쿼터 사용률을 확인합니다.
  4. Tier의 초기화 주기 이후 다시 요청하거나 API 키의 엔드포인트 설정에서 다른 Tier를 적용합니다.

사용량 제한이 필요하지 않다면 API 키와 엔드포인트의 연결에서 Tier 선택을 해제할 수 있습니다.

비공개 Hugging Face 모델을 불러올 수 없는 경우​

비공개 또는 인증이 필요한 Hugging Face 모델은 Access Token이 없거나 올바르지 않으면 모델 파일을 불러올 수 없습니다.

  1. Hugging Face에서 hf_로 시작하는 Access Token을 확인합니다.
  2. 인증 정보 > Secret에서 HF Token 유형의 Secret을 생성합니다.
  3. 커스텀 모델을 새로 만들거나 새 Revision을 생성할 때 고급 설정 > Secret에서 생성한 Secret을 선택합니다.
  4. 기존 엔드포인트를 사용하는 경우 신규 버전 적용을 실행합니다.
  5. 엔드포인트가 Active 상태가 된 후 로그 조회 탭에서 모델 로드 결과를 확인합니다.

새 모델 Revision이 엔드포인트에 반영되지 않는 경우​

새 Revision은 기존 엔드포인트에 자동으로 적용되지 않습니다.

  1. 엔드포인트가 Active 또는 Stopped 상태인지 확인합니다.
  2. 엔드포인트의 더보기 메뉴에서 [신규 버전 적용]을 클릭합니다.
  3. 적용할 모델 버전을 선택하고 [적용]을 클릭합니다.
  4. 신규 버전 적용이 완료된 후 배포된 모델 버전을 확인합니다.

엔드포인트 작업 버튼이 비활성화된 경우​

엔드포인트 상태에 따라 사용할 수 없는 작업은 비활성화됩니다.

  • Creating, Provisioning, Updating, Stopping: 삭제만 실행할 수 있습니다.
  • Deleting: 신규 버전 적용, 상태 변경, 수정, 삭제를 실행할 수 없습니다.
  • Active: 모든 작업을 실행할 수 있습니다.
  • Stopped: 신규 버전 적용, 상태 변경, 삭제를 실행할 수 있습니다.
  • Failed: 삭제만 실행할 수 있습니다.

상태가 전환 중이라면 작업이 끝난 후 다시 확인하세요.