일반적인 문제

Classic/VPC 환경에서 이용 가능합니다.

CLOVA Studio를 사용하면서 발생할 수 있는 문제와 해결 방법에 대해 설명합니다.

동시 요청 급증 시 오류

다수 사용자가 동시에 API 요청을 보냈을 때 오류가 발생합니다.

원인

CLOVA Studio는 사용자가 특정 시간 내에 이용할 수 있는 API 요청 횟수와 토큰 수에 상한선을 두고 있습니다. 정책에 대한 자세한 내용은 CLOVA Studio 이용량 제어 정책을 참조해 주십시오.

해결 방법

• QPM 수치를 미리 확인한 후 최댓값 이내로 요청해 주십시오.
• 별도의 API 호출 제어 기능(rate limit)을 직접 구현 및 추가해 주십시오.
• 요청 사이에 일정 시간 지연 기능(time sleep)을 별도로 추가해 주십시오.
• HTTP 429 코드 반환 및 해당 오류 메시지 응답 시 예외 처리를 통해 일정 시간 지연 이후 재요청해 주십시오.
• 최대 이용량을 초과하지 않도록 관리하는 방법은 최대 이용량 관리를 참조해 주십시오.

오류 코드 반환

API 호출 시 오류 코드가 반환되었습니다.

원인

오류 코드별로 원인과 조치 방법이 다릅니다. API 요청 형식, 인증 정보, Rate Limit 초과 등 다양한 요인이 존재합니다.

해결 방법

반환된 오류 코드를 기준으로 원인과 해결 방법을 확인해야 합니다. 상세한 오류 코드별 설명은 CLOVA Studio API 가이드의 CLOVA Studio 문제 해결을 참조해 주십시오.

서비스 앱 수정/삭제 불가

서비스 앱 신청/등록 후 수정하거나 삭제할 수 없습니다.

원인

서비스 앱의 수정 및 삭제 기능을 제공하지 않습니다.

해결 방법

서비스 앱 수정이 필요한 경우, 작업을 새로 수행한 뒤 서비스 앱을 신청해주십시오.
동일 모델 및 API에 대한 서비스 앱에서 프롬프트 및 파라미터만 수정이 필요한 경우, 이미 등록된 서비스 앱의 API 호출 정보를 변경해도 무방합니다. 단, 서비스 앱을 적용하고자 하는 서비스 정보가 변경될 경우에는 새로 신청해 주십시오.

서비스 앱 신청 시 신청할 작업이 표시되지 않음

서비스 앱 신청 정보에서 신청 모델을 선택한 후에, 신청할 작업 목록에 아무것도 나타나지 않습니다.

원인

서비스 앱 심사자가 작업 내용을 직접 확인할 수 있도록 플레이그라운드 및 튜닝 작업을 저장하고 공유 URL을 생성해야 합니다. 신청 모델을 사용하여 작업을 생성한 후 저장한 경우에만 신청할 작업 목록에 노출됩니다.

해결 방법

• 신청할 모델로 작업을 생성한 후 저장해 주십시오.
• 플레이그라운드에 작업 생성 및 공유 설정이 되어있는지 확인해 주십시오. 작업 공유 URL 생성 방법은 작업 공유를 참조해 주십시오.