--- title: "AI·NAVER API 개요" slug: "naveropenapiv3-application" tags: ["Application Service", "공통", "AI·NAVER API"] updated: 2026-08-20T09:03:13Z published: 2026-08-20T09:03:13Z canonical: "guide-gov.ncloud-docs.com/naveropenapiv3-application" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # AI·NAVER API 개요 Classic/VPC 환경에서 이용 가능합니다. AI·NAVER API 서비스는 네이버 클라우드 플랫폼의 다양한 인공지능 서비스를 손쉽게 구축하고 안정적으로 운영할 수 있도록 API 형태로 제공합니다. AI·NAVER API 서비스를 이용하려면 Application 정보를 등록하고 관리하는 절차가 필요합니다. 아래의 내용을 확인한 후 절차에 맞게 사용해 주십시오. - [이용 신청](/docs/naveropenapiv3-application#%EC%9D%B4%EC%9A%A9%EC%8B%A0%EC%B2%AD) - [Application 등록](/docs/naveropenapiv3-application#Application%EB%93%B1%EB%A1%9D) - [Application 정보 확인](/docs/naveropenapiv3-application#Application%EC%A0%95%EB%B3%B4%ED%99%95%EC%9D%B8) - [Application 수정](/docs/naveropenapiv3-application#Application%EC%88%98%EC%A0%95) - [이용 관리](/docs/naveropenapiv3-application#%EC%9D%B4%EC%9A%A9%EA%B4%80%EB%A6%AC) - [당일/당월 이용량 확인](/docs/naveropenapiv3-application#%EB%8B%B9%EC%9D%BC%EB%8B%B9%EC%9B%94%EC%9D%B4%EC%9A%A9%EB%9F%89%ED%99%95%EC%9D%B8) - [이용 한도 설정](/docs/naveropenapiv3-application#%EC%9D%B4%EC%9A%A9%ED%95%9C%EB%8F%84%EC%84%A4%EC%A0%95) - [임계치 알림 설정](/docs/naveropenapiv3-application#%EC%9E%84%EA%B3%84%EC%B9%98%EC%95%8C%EB%A6%BC%EC%84%A4%EC%A0%95) - [통보 대상 설정](/docs/naveropenapiv3-application#%ED%86%B5%EB%B3%B4%EB%8C%80%EC%83%81%EC%84%A4%EC%A0%95) - [API 호출량 확인](/docs/naveropenapiv3-application#API%ED%98%B8%EC%B6%9C%EB%9F%89%ED%99%95%EC%9D%B8) - [이용 해지](/docs/naveropenapiv3-application#%EC%9D%B4%EC%9A%A9%ED%95%B4%EC%A7%80) ## 이용 신청 네이버 클라우드 플랫폼의 AI·NAVER API 서비스 최초로 이용하는 경우 네이버 클라우드 플랫폼 콘솔에서 AI·NAVER API 서비스 이용 약관에 동의해야 합니다. AI·NAVER API 서비스 이용 약관은 사용자의 권리 및 의무, 이용 제한 및 이용 요금, 특약 조건 등에 대한 내용을 담고 있으므로 서비스 이용 전 반드시 확인이 필요합니다. 참고 이미 AI·NAVER API의 다른 서비스를 이용 중인 경우 이용 약관에 동의하는 과정은 생략되므로 [Application 등록](/docs/naveropenapiv3-application#application%EB%93%B1%EB%A1%9D)으로 이동해 주십시오. AI·NAVER API 서비스 이용 약관에 동의하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오. 2. 콘솔 화면 우측 상단의 **리전 & 플랫폼** 버튼을 클릭해 주십시오. 3. 이용 중인 리전과 플랫폼을 선택한 후 **[적용]** 버튼을 클릭해 주십시오. 4. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오. 5. **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 6. **Application** 메뉴를 클릭해 주십시오. 7. **[Applicaiton 등록]** 버튼을 클릭해 주십시오. 8. **AI·NAVER API 이용약관** 화면이 나타나면 **AI·NAVER API 이용약관에 동의합니다.** 를 클릭해 주십시오. 9. **[확인]** 버튼을 클릭해 주십시오. 10. 등록할 수 있는 Application 목록을 확인하고 다음 과정을 진행해 주십시오. - [Application 등록](/docs/naveropenapiv3-application#Application%EB%93%B1%EB%A1%9D) - [Application 정보 확인](/docs/naveropenapiv3-application#Application%EC%A0%95%EB%B3%B4%ED%99%95%EC%9D%B8) - [Application 수정](/docs/naveropenapiv3-application#Application%EC%88%98%EC%A0%95) 참고 Application을 등록하면 Application 한 개 당 고유한 Client ID와 Client Secret 값이 생성됩니다. Client ID와 Client Secret 값은 API 호출 시 HTTP 헤더값에 포함되어 전송됩니다. API 호출 방법에 대한 자세한 설명은 네이버 클라우드 플랫폼 API 가이드의 [NAVER 연동 API 호출](https://api-gov.ncloud-docs.com/docs/common-naverapi-naverapi)을 참조해 주십시오. ### Application 등록 Application을 등록하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. **[Applicaiton 등록]** 버튼을 클릭해 주십시오. 4. **Application 이름**을 입력해 주십시오. - 최대 20 자까지 입력 가능 - 서비스 성격에 따라 Application 이름이 화면에 출력될 수 있으므로 10자 이내로 입력 권장 5. **Service 선택** 영역에서 사용하려는 서비스 클릭하여 선택해 주십시오. - **[서비스 설명/요금 안내]** 버튼: 클릭 시 네이버 클라우드 플랫폼 포털의 서비스 소개 화면으로 이동 - **[개발 가이드]** 버튼: 클릭 시 해당 서비스의 사용 가이드로 이동 6. **서비스 환경 등록** 영역에서 Application의 서비스 환경을 입력해 주십시오. 참고 - 하나의 Application에 발급된 Client ID와 Secret 값을 안드로이드, iOS, 웹, Windows App 등 여러 환경에 적용할 수 있습니다. 단, API 사용량은 클라이언트 아이디별로 합산됩니다. - Web 서비스 URL은 여러 개 추가할 수 있으나 Android 앱 패키지나 iOS Bundle ID는 하나씩만 등록할 수 있습니다. - Web 서비스 URL - http://로 시작하는 웹 서비스 URL을 최대 10개까지 입력 가능 - http와 https는 구분하지 않으며, www는 제외하고 입력 <예시> http://naver.com - 서브 도메인이 있는 경우 대표 도메인만 입력 - 서비스 URL과 이용하는 웹의 정보가 다른 경우 인증 실패할 수 있음 - 하이브리드 앱은 location.href 객체 출력값 입력 <예시> file://로컬 URL - Android 앱 패키지 이름 - Android 애플리케이션만 해당하며, 최대 10개까지 입력 가능 - 입력한 패키지 이름과 이용하는 앱의 패키지 이름이 다른 경우 인증 실패할 수 있음 - iOS Bundle ID - iOS 애플리케이션만 해당하며, 최대 10개까지 입력 가능 - 등록된 Bundle ID와 이용하는 앱의 정보가 다른 경우 인증 실패할 수 있음 7. **[등록]** 버튼을 클릭해 주십시오. ### Application 정보 확인 등록된 Application 목록은 네이버 클라우드 플랫폼 콘솔의 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** > **Application** 메뉴에서 확인할 수 있습니다. Application 목록에서 Application 정보를 확인하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. Application 정보를 확인해 주십시오. - **App 이름**: Application 등록 시 설정한 앱의 이름 - **서비스 구분**: Application 등록 시 선택한 서비스 - **당일/당월 사용량**: 서비스별 실시간 사용량 (UTC+9 기준) - **한도 및 알림 설정**: API 호출 이용 한도와 특정 값(%) 초과 시 알림 설정 ` * **등록일**: Application을 등록한 날짜 4. **[인증 정보]** 버튼을 클릭해 주십시오. ![ainaverapi_01_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ainaverapi_01_ko.png) 5. 인증 정보 창이 나타나면 인증 정보를 확인해 주십시오. - **Application Key** - **Application 이름**: Application을 구분하는 이름 - **Client ID** (X-NCP-APIGW-API-KEY-ID): 인증에 필요한 ID로 헤더 또는 쿼리 스트링에 'X-NCP-APIGW-API-KEY-ID'로 입력. ![ainaverapi_05_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ainaverapi_05_ko.png) 클릭 시 값 복사 가능 - **Client Secret** (X-NCP-APIGW-API-KEY): 인증에 필요한 SecretKey 비밀번호로 헤더 또는 쿼리 스트링에 'X-NCP-APIGW-API-KEY'로 입력. ![ainaverapi_05_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ainaverapi_05_ko.png) 클릭 시 값 복사 가능하며 **[재발급]** 버튼 클릭 시 값 변경 가능 - **서비스 환경** - **Web 서비스 URL**: Web SDK를 사용하기 위해 필요한 값 - **Android 앱 패키지 이름**: Android SDK를 사용하기 위해 필요한 값 - **iOS Bundle ID**: iOS SDK를 사용하기 위해 필요한 값 6. **[확인]** 버튼을 클릭해 주십시오. 주의 Client ID와 Client Secret이 외부에 노출되지 않도록 주의해 주십시오. 보안이 우려되는 경우 7.에서 인증 정보를 새로운 값으로 재발급해 주십시오. ### Application 수정 등록한 Application 정보를 수정하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. 수정할 Application의 **[수정]** 버튼을 클릭해 주십시오. 4. 필요한 정보를 수정한 다음 **[저장]** 버튼을 클릭해 주십시오. ## 이용 관리 등록한 Application별 이용 현황을 확인하고 과금 관리를 위한 다양한 옵션을 설정할 수 있습니다. ### 당일/당월 이용량 확인 당일 이용량과 당월 이용량을 확인하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. Application 목록에서 이용량을 확인할 애플리케이션의 당일 이용량과 당월 이용량의 실시간 이용 현황을 확인해 주십시오. - UTC+9 기준 - 한국 시간 기준으로 00:00 AM에 일별 이용량이 0으로 초기화 참고 실제 당일/당월 사용량은 반영되기까지 약 1분 정도 시간이 소요됩니다. ### 이용 한도 설정 서비스 이용 요금이 과도하게 청구되는 것을 방지하기 위해 일별, 월별 이용 한도를 직접 설정할 수 있습니다. 이용 한도를 설정하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. Application 목록에서 이용 한도를 변경할 애플리케이션의 **[한도 및 알림 설정]** 버튼을 클릭해 주십시오. ![ainaverapi_02_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ainaverapi_02_ko.png) 4. **[한도 설정]** 탭 메뉴에서 월별 한도 값과 일별 한도 값을 입력해 주십시오. ![ainaverapi_03_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ainaverapi_03_ko.png) 5. **[저장]** 버튼을 클릭해 주십시오. 참고 이용 한도를 변경한 이력은 **한도 및 알림 설정** 팝업 창의 **[한도 변경 이력]** 탭 메뉴에서 확인할 수 있습니다. ### 임계치 알림 설정 사용자가 설정한 일별/월별 한도 값의 특정 사용률을 초과한 경우, 이메일 또는 SMS로 알림을 받을 수 있습니다. 임계치 알림을 설정하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. Application 목록에서 이용 한도를 변경할 애플리케이션의 **[한도 및 알림 설정]** 버튼을 클릭해 주십시오. 4. **[한도 설정]** 탭 메뉴에서 월별 한도 설정 또는 일별 한도 설정 항목의 체크 박스를 클릭하여 선택해 주십시오. 5. 알림 기준이 될 임계치 값(%)을 선택해 주십시오. ![ainaverapi_04_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ainaverapi_04_ko.png) - 70%을 선택한 경우, 70%, 80%, 90%, 100%에 알림 - 90%을 선택한 경우, 90%, 100%에 알림 6. **[저장]** 버튼을 클릭해 주십시오. 7. [통보 대상 설정](/docs/naveropenapiv3-application#%ED%86%B5%EB%B3%B4%EB%8C%80%EC%83%81%EC%84%A4%EC%A0%95)을 참조하여 임계치 알림 설정을 받을 주소를 입력해 주십시오. 참고 임계치 알림을 설정했더라도 통보 대상자를 설정하지 않으면 알림이 수신되지 않습니다. 반드시 통보 대상자를 설정해 주십시오. ### 통보 대상 설정 사용자가 설정한 일별/월별 한도 값의 특정 사용률을 초과한 경우 알림을 받을 수신자와 수신 방법을 설정하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. Application 목록에서 이용 한도를 변경할 애플리케이션의 **[한도 및 알림 설정]** 버튼을 클릭해 주십시오. 4. **[통보대상 설정]** 탭 메뉴를 클릭해 주십시오. 5. 통보 대상 담당자를 선택하고 통보 방법을 선택한 후 **[추가]** 버튼을 클릭해 주십시오. - 신규 담당자를 추가하기 위해 Cloud Insight(Monitoring)로 이동하려면 **[통보 대상 관리]** 버튼 클릭 6. 통보 대상자 설정이 완료되면 **[저장]** 버튼을 클릭해 주십시오. 참고 통보 대상 설정에서는 등록된 통보 대상 담당자만 선택할 수 있습니다. 새로운 담당자를 등록하는 작업은 Cloud Insight의 Notification Recipient 메뉴에서 수행할 수 있습니다. 자세한 설명은 Notification Recipient 사용 가이드 [대상자 추가](/docs/notification-recipient-use#%EB%8C%80%EC%83%81%EC%9E%90%EC%B6%94%EA%B0%80)를 참조해 주십시오. ### API 호출량 확인 API 호출량을 그래프로 확인하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Usage Statistics** 메뉴를 클릭해 주십시오. 3. API 호출량을 확인할 애플리케이션 이름과 서비스를 선택하고 조회 기간을 설정한 후 **[조회]** 버튼을 클릭해 주십시오. 4. 그래프를 확인해 주십시오. - API 호출 수를 성공/실패 그래프로 확인 - 서비스별 과금 단위에 따른 이용량을 확인 5. 조회 결과를 엑셀 파일로 다운로드하려면 **[다운로드]** 버튼을 클릭해 주십시오. ## 이용 해지 API로 제공되는 서비스는 이용 해지 과정이 별도로 존재하지 않습니다. 생성한 서비스의 Application을 삭제한 경우 이용 해지가 된 것입니다. Application을 삭제하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** 메뉴를 차례대로 클릭해 주십시오. 2. **Application** 메뉴를 클릭해 주십시오. 3. 삭제할 서비스의 Application을 클릭한 다음 **[삭제]** 버튼을 클릭해 주십시오. 4. **앱 삭제** 팝업 창이 나타나면 **[확인]** 버튼을 클릭해 주십시오.