Application
    • PDF

    Application

    • PDF

    Article Summary

    Available in Classic and VPC

    Once you have confirmed the CLOVA Speech Recognition support specifications, you are ready to start using CLOVA Speech Recognition. Now, what you do is to process and manage applications for use of CLOVA Speech Recognition. You can request and manage subscription to CLOVA Speech Recognition in the Application menu of NAVER Cloud Platform Console.

    Note

    CLOVA Speech Recognition is an API based service, you can only request, cancel, and manage subscription in the NAVER Cloud Platform Console.

    The following summarizes what you can learn from this guide.

    Request subscription

    Request subscription to CLOVA Speech Recognition does not require a separate procedure. You can create and manage subscription directly from Services > AI·NAVER API > AI· NAVER API in the NAVER Cloud Platform Console. To create an application, you must agree to the API service terms and conditions in the NAVER Cloud Platform console. The API service terms and conditions contain the rights and obligations of the user, usage restrictions and usage fees, and special terms and conditions, so you must check them before using CLOVA Speech Recognition.

    Note

    You must agree to the API service terms and conditions when you use NAVER Cloud Platform's AI·NAVER API service for the first time. If you are already using other AI·NAVER API services, you can skip the process, so please go to Register Application.

    To use CLOVA Speech Recognition, you can agree to the API service terms and conditions as follows.

    1. Access the NAVER Cloud Platform console.
    2. From the Region menu, click and select the region you're using.
    3. From the Platform menu, click to select between VPC and Classic.
    4. Click the Services > AI·NAVER API > AI·NAVER API menu in order.
    5. Click the Application menu.
    6. Click the [Register application] button.
    7. When the AI·Naver API Terms and Conditions screen appears, agree to the AI·Naver API Terms and Conditions. Click .
    8. Click the [OK] button.
    9. Check the list of applications that can be registered and proceed to the next step.
    Note

    You can go directly to the screen in 6. by clicking the [Apply for Use] button in Service > AI Services > CLOVA Speech Recognition (CSR) of the NAVER Cloud Platform portal.

    Register application

    After agreeing to the API service terms and conditions, you must register the application. You must require the application to use the CLOVA Speech Recognition. When an application is registered, a unique Client ID and Client Secret value are created for each application. This is because the Client ID and Client Secret value are included in the HTTP header value and transmitted when calling the API.

    Note

    For a detailed description of how to call the API, see NAVER Integrated API Call in NAVER Cloud Platform API Guide.

    The following describes how to register an application.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.

    2. From the Platform menu, click to select between VPC and Classic.

    3. Click the Services > AI·NAVER API > AI·NAVER API menu in order.

    4. Click the Application menu.

    5. Click the [Register application] button.

    6. Enter the application name.

      • Up to 20 characters can be entered.
      • The application name may be displayed on the screen depending on the service's characteristics, so using a name up to 10 characters is recommended.
    7. Click to select CLOVA Speech Recognition (CSR) in the service selection area.

      • [Service description/pricing information] button: Click and go to the service introduction screen of NAVER Cloud Platform portal
      • [Development guide] button: Click and go to CLOVA Speech Recognition (CSR) guide
    8. Enter the service environment of the application in the service environment registration area.

      • Web service URL
        • Up to 10 web service URLs with http:// can be entered.
        • No difference between http and https. Enter excluding www. <example> http://naver.com
        • Enter the main domain only even if there are sub-domains.
        • If information of the service URL differs to the web used, the authentication may Available
        • For hybrid apps, input location.href object output <example> file://local URL
      • Android App package name
        • For Android applications only, up to 10 inputs are allowed.
        • If the entered package name differs to the package name of the using app, the authentication may fail
      • iOS Bundle ID
        • For iOS applications only, up to 10 inputs are allowed.
        • If the registered bundle ID differs to the information of the using app, the authentication may fail.
      Note
      • When selecting CLOVA Speech Recognition (CSR), an Android app package name or iOS bundle ID must be entered. Some restrictions may apply on using the SDK if it is not provided.
      • The client ID and secret value issued for one application may be applied to multiple environments including Android, iOS, web, Windows App, etc. Please note that the API usage is added up by each client ID.
    9. Click the [Register] button.

    View application information

    You can check the list of registered applications in the AI·NAVER API > AI·NAVER API > Application menu in the NAVER Cloud Platform Console. The following describes how to check application information in the application list.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.
    2. From the Platform menu, click to select between VPC and Classic.
    3. Click the Services > AI·NAVER API > AI·NAVER API menu in order.
    4. Click the Application menu.
    5. Check application information.
      • App name: App's name when registering application
      • Service category: Selected service when registering application
      • Daily/monthly usage: Real-time usage by service (based on UTC+9)
      • Limit and notification setting: API call usage limit and notification setting when a specific value (%) is exceeded
      • Registration date: The date the application was registered
    6. Click the [Authentication information] button.

    clovasummary-application_02_ko

    1. When the authentication information window appears, check the authentication information.
      • Application Key
        • Application name: Name to identify the application
        • Client ID (X-NCP-APIGW-API-KEY-ID): Enter 'X-NCP-APIGW-API-KEY-ID' in the header or query string as the ID required for authentication.
          clovasummary-ico_01 Can copy value on click
        • Client Secret (X-NCP-APIGW-API-KEY-ID): Enter 'X-NCP-APIGW-API-KEY' in the header or query string as the SecretKey required for authentication.
          clovasummary-ico_01 Can copy value on click, and change value with clicking the [Reissue] button
      • Service environment
        • Web service URL: Required value to use Web SDK
        • Android app package name: Required value to use Android SDK Value
        • iOS Bundle ID: Required value to use iOS SDK
    2. Click the [OK] button.
    Caution

    Please make sure the client ID and client secret are kept confidential. If you are concerned about security, please reissue the authentication information with new values in 7.

    Edit application

    The following describes how to edit the registered application information.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.
    2. From the Platform menu, click to select between VPC and Classic.
    3. Click the Services > AI·NAVER API > AI·NAVER API menu in order.
    4. Click the Application menu.
    5. Click the [Settings] button of Application you want to edit.
    6. Edit the necessary information, and then click the [Save] button.

    Manage usage

    You can check usage status for each registered application and set various options for billing management.

    Check daily/monthly usage

    You can see the usage for the day and for the current month as follows.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.
    2. From the Platform menu, click to select between VPC and Classic.
    3. Click the Services > AI·NAVER API > AI·NAVER API menu in order.
    4. Click the Application menu.
    5. In the application list, check the real-time usage status of the daily usage and current month usage of the application you want to check usage for.
      • It is based on UTC+9.
      • The daily usage is reset to 0 at 00:00 AM Korean Initialization
    Note

    It takes about 1 minute to reflect the actual daily/monthly usage.

    Set usage limits

    You can set up daily and monthly usage limits yourself, to prevent excessive usage fees being charged. The following describes how to set up a usage limit.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.
    2. From the Platform menu, click to select between VPC and Classic.
    3. Click the Services > AI·NAVER API > AI·NAVER API menu in order.
    4. Click the Application menu.
    5. Click the [Set limits and notifications] button of the application you want to edit the usage limit from the application list.

    clovasummary-application_03_ko

    1. Enter the monthly and daily limit values under the [Set limits] tab menu.

    clovasummary-application_04_ko

    1. Click the [Save] button.
    Note

    You can check the change history of usage limit under the [Limit change history] tab in the limits and notifications setting pop-up.

    Set threshold notifications

    You can choose to receive notifications via email or SMS if a certain usage rate of the daily/monthly limit value set by the user is exceeded. You can set up a threshold notification as follows.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.
    2. From the Platform menu, click to select between VPC and Classic.
    3. Click the Services > AI·NAVER API > AI·NAVER API menu in order.
    4. Click the Application menu.
    5. Click the [Set limits and notifications] button of the application you want to edit the usage limit from the application list.
    6. Click the checkbox for the daily or monthly limit settings field under the [Set limits] tab menu.
    7. Select the threshold value (%) to be a notification point.

    clovasummary-application_05_ko

    * If 70% is selected, notifications are sent at 70%, 80%, 90%, and 100%
    * If 90% is selected, notifications are sent at 90% and 100%
    8. Click the [Save] button.
    9. Enter the address you want to receive the threshold notifications by referring to notification recipients setting.

    Note

    You won't receive notifications if you don't have notification recipients set up, even if you've set up threshold notifications. Make sure to set notification recipients.

    Set notification recipients

    The following describes how to set up notification recipients and notification methods for when a certain usage rate of the daily/monthly limit value set by the user is exceeded.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.
    2. From the Platform menu, click to select between VPC and Classic.
    3. Click the Services > AI·NAVER API > AI·NAVER API menu in order.
    4. Click the Application menu.
    5. Click the [Set limits and notifications] button of the application you want to edit the usage limit from the application list.
    6. Click the [Set notification recipients] tab menu.
    7. Select a person in charge to receive notifications and notification method, and then click the [Add] button.
      • To go to Cloud Insight (Monitoring) to add a new person in charge, click the [Manage notification recipients] button
    8. Once you complete setting up the notification recipients, click the [Save] button.
    Note

    You can select only registered notification recipients in the notification recipients settings. You can add a new contact person in the Notification Recipient menu from Cloud Insight. For more details, see Add Recipient in the Notification Recipient guide.

    Cancel subscription

    Cancellation of CLOVA Speech Recognition subscription does not require a separate procedure. If you delete the application of CLOVA Speech Recognition you created, your application for use is canceled. The following describes how to delete an application.

    1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.
    2. From the Platform menu, click to select between VPC and Classic.
    3. Click the Services > AI Services > AI·NAVER API menu in order.
    4. Click the Application menu.
    5. Click the Application of CLOVA Speech Recognition to be deleted, then click the [Delete] button.
    6. When the Delete app pop-up window is displayed, click the [OK] button.

    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.