CLOVA Studio 개요

인쇄
공유
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

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

초대규모(Hyperscale) AI 기술인 HyperCLOVA 언어 모델을 활용하여 사용자가 입력한 내용에 따라 AI 기술을 통해 생성된 문구를 출력하는 네이버 클라우드 플랫폼의 서비스입니다.

오퍼레이션

CLOVA Studio에서 제공하는 오퍼레이션은 다음과 같습니다.

API	설명
Chat Completions	HyperCLOVA X 모델을 활용한 대화형 문장 생성
Completions	문장 생성
학습 생성	사용자의 데이터셋을 사용한 학습 생성
학습 조회	생성한 학습 1건 정보 조회
학습 목록 조회	생성한 학습 목록 조회
학습 모델 Chat Completions	학습 모델을 활용한 대화형 문장 생성
스킬셋 답변 생성	스킬셋 API 호출로 답변 생성

참고

CLOVA Studio에서 제공하는 익스플로러 관련 API 명세는 CLOVA Studio 웹에서 확인할 수 있습니다.

공통 설정

CLOVA Studio API에서 공통으로 사용하는 형식이나 설정을 설명합니다.

테스트 앱 생성

테스트 앱을 생성하면 API를 사용할 수 있습니다.

요청

CLOVA Studio API에서 공통으로 사용하는 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://clovastudio.apigw.ntruss.com/

참고

Chat completions에서 스트리밍 응답을 이용하려는 경우에는 별도의 API URL을 사용해야 합니다. 다음 내용을 참조해 주십시오.

응답

CLOVA Studio API에서 공통으로 사용하는 응답 형식을 설명하고 구문 예시를 안내합니다.

바디

바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
status	object	N	응답 상태
status.code	string	N	응답 상태 코드
status.message	string	N	응답 메시지
result	any	Y	응답 결과

응답 상태 코드

응답 상태 코드를 설명합니다.

HTTP 상태 코드	코드	메시지	설명
200	20000	OK	요청 처리 성공
204	20400	No content	요청 처리 성공, 콘텐츠를 반환하지 않음
400	40000	Bad request	잘못된 요청
400	40001	Invalid parameter	잘못된 요청 파라미터
400	40003	Text to long	너무 긴 요청 텍스트
400	40004	Text empty	빈 텍스트로 요청
400	40005	Unavailable output 1	결과를 제공할 수 없는 요청
400	40006	Unavailable output 2	결과를 제공할 수 없는 요청
400	40009	Unsupported function	지원하지 않는 기능 요청
400	40010	input_text_empty	스킬: query(질의), thought(생각), action(액션), actionInput(액션 입력), observe(관찰) 파라미터를 공란으로 요청
400	40020	missing_input_value	스킬: 입력 값 일부 누락
400	40030	invalid Action	스킬: 정의되지 않은 action(액션) 입력
400	40040	invalid Action Input	스킬: 잘못된 actionInput(액션 입력) 입력
400	40050	internal parsing error	스킬: 내부 파싱 오류
400	40080	model not found	모델 찾을 수 없음
401	40100	Unauthorized	인증 실패
401	40101	Invalid signature	잘못된 요청 서명
401	40102	Invalid access token	액세스 토큰 만료
401	40103	Access token expired	서버 작업 거부
401	40104	Invalid key	유효하지 않은 인증 키
401	40170	No subscription request history found. Please request a subscription to use	CLOVA Studio 이용 신청 이력을 찾을 수 없음
403	40300	Forbidden	서버 작업 거부
403	40301	No ownership	소유권 없음
404	40400	Not found	요청 리소스 찾지 못함
406	40600	Not Acceptable	잘못된 미디어 형식
408	40800	Request timeout	요청 처리 시간 초과
415	41500	MediaType error	지원하지 않는 미디어 형식
415	41501	No multipart boundary Content-Type	multipart 사용이 필요하지만 형식에 맞지 않는 요청
429	42900	Too many requests	너무 많은 요청
429	42901	Too many requests - rate exceeded	너무 많은 요청 (최대 이용량 초과)
429	42902	Too many requests - overloaded	너무 많은 요청 (트래픽 과다)
500	50000	Internal server error	내부 서버 오류
500	50010	no final answer	스킬: API 호출 시 final_answer 누락
500	51010	플래닝 가능한 툴이 없습니다.	스킬: 플래닝 가능한 툴 없음
500	51020	플래닝 중 알 수 없는 오류가 발생하였습니다. {reason}	스킬: 플래닝 중 알 수 없는 오류 발생
500	51030	주어진 쿼리에 대해 플래닝이 불가합니다. 이유는 다음과 같습니다. {reason}	스킬: 플래닝 작업 거부
500	52020	json을 잘못 생성 하였습니다. 답변을 할 수 없습니다.	스킬: 판별기에서 LLM이 판단한 결과를 json parsing 할 때 오류 발생
500	52030	skillSet을 잘못 생성하였습니다. 답변을 할 수 없습니다.	스킬: 판별기에서 생성한 skillSet이 입력한 skillSet에 존재하지 않는 경우
500	53010	검색 API parsing에 실패 하였습니다.	스킬: 검색 API 결과를 전처리 하는 도중 오류 발생
500	53020	원문 길이가 짧아 요약할 수 없습니다.	스킬: 원문이 char_size 기준 100자 미만인 경우 오류 발생
500	60000	HyperCLOVA API Error url:{url}	스킬: HyperCLOVA 관련 오류
500	64000	{HyperCLOVA error message}	스킬: HyperCLOVA 입력 관련 오류(text too long 등)
500	64240	{HyperCLOVA error message}	스킬: HyperCLOVA 생성 관련 오류(lora url 문제 등)
500	64290	{HyperCLOVA error message}	스킬: HyperCLOVA too many requests 오류
500	65000	{HyperCLOVA error message}	스킬: HyperCLOVA internal server error
501	50100	Not yet implemented	구현되지 않은 API 호출
504	50400	Gateway timeout	게이트웨이 처리 시간 초과

참고

위 상태 코드 외 네이버 클라우드 플랫폼의 공통 상태 코드는 NAVER 연동 API를 확인해 주십시오.

구문

공통 응답 구문 예시를 안내합니다.

성공

{
  "status": {
    "code": "20000",
    "message": "OK"
  },
  "result": {}
}

실패(클라이언트 오류)

{
"status": {
"code": "40102",
"message": "Invalid access token"
    }
}

실패(서버 오류)

{
"status": {
"code": "50000",
"message": "Internal Server Error"
    }
}

이 문서가 도움이 되었습니까?

What's Next

Chat Completions

오퍼레이션
공통 설정

태그

CLOVA Studio