Application

Prev Next

Available in Classic and VPC

Once you've reviewed the CLOVA Speech Recognition specifications, you're ready to start using the service. Your next step is subscribing to and managing CLOVA Speech Recognition. You can request and manage your subscription to CLOVA Speech recognition in the Application menu of NAVER Cloud Platform Console.

Note

Since CLOVA Speech Recognition is an API-based service, you can only request, cancel, and manage subscriptions in the NAVER Cloud Platform console.

Here are the key points you will learn through this guide:

Subscribe to the service

There is no separate procedure for subscribing to CLOVA Speech Recognition. You can create and manage an application directly from i_menu > Services > AI·NAVER API > AI·NAVER API in the NAVER Cloud Platform console. To create an application, you must agree to the API terms of service in the NAVER Cloud Platform console. The API terms of service contain the rights and obligations of the user, usage restrictions and pricing information, and special terms and conditions, so you must check them before using CLOVA Speech Recognition.

Note

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

To agree to the API terms of service for using CLOVA Speech Recognition:

  1. Access the NAVER Cloud Platform console.
  2. Click Region & Platform in the upper-right corner of the console interface.
  3. Select the region and platform you are using, and click [Apply].
  4. Click i_menu in the upper-left corner of the console interface.
  5. Click **Services ** > AI·NAVER API ** > ** AI·NAVER API in order.
  6. Click the Application menu.
  7. Click [Register application].
  8. When the AI·NAVER API terms of service interface appears, click Agree to the AI·NAVER API terms of service.
  9. Click [OK].
  10. Check the list of applications that you can register and proceed to the following steps:
Note

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

Register application

You must register the application after agreeing to the API terms of service. The application is required to use the CLOVA Speech Recognition API. 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 more information about how to call APIs, see NAVER integrated API call in NAVER Cloud Platform API guide.

To register an application:

  1. From the NAVER Cloud Platform console, navigate to i_menu > Services > AI·NAVER API > AI·NAVER API.
  2. Click the Application menu.
  3. Click [Register application].
  4. Enter the application name.
    • Up to 20 characters can be entered.
    • Depending on the service, the application name may be displayed on the interface, so use a name of up to 10 characters.
  5. In the Select service component, click and select CLOVA Speech Recognition (CSR).
    • [Service description/Pricing information]: Navigate to the service introduction interface of the NAVER Cloud Platform portal.
    • [Development guide]: Navigate to the CLOVA Speech Recognition (CSR) user guide.
  6. From the Service environment registration component, enter the service environment of the application.
    • Web service URL
      • Up to 10 web service URLs that begin 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 subdomains.
      • If information of the service URL differs from the web used, the authentication may fail.
      • For hybrid apps, enter location.href object outputs. Example: file://local URL
    • Android app package name.
      • For Android applications only, up to 10 can be entered.
      • If the entered package name differs from the package name of the app in use, the authentication may fail.
    • iOS Bundle ID.
      • For iOS applications only, up to 10 can be entered.
      • If the registered bundle ID differs from the information of the app used, 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 1 application may be applied to multiple environments including Android, iOS, web, and Windows App. However, the API usage is added up by each client ID.
  7. Click [Register].

Check application information

You can check the list of registered applications in i_menu > Services > AI·NAVER API > AI·NAVER API > Application on NAVER Cloud Platform console. To check application information from the application list:

  1. From the NAVER Cloud Platform console, navigate to i_menu > Services > AI·NAVER API > AI·NAVER API.
  2. Click the Application menu.
  3. Check application information.
    • App name: The name of the app set when registering the application.
    • Service type: The service selected when registering the application.
    • Daily/monthly usage: Real-time usage by service (based on UTC+9).
    • Limit and notification settings: API call usage limit and notification setting when a specific value (%) is exceeded.
    • Registration date: The date the application was registered.
  4. Click [Authentication information].
    clovasummary-application_02_ko
  5. When the authentication information window appears, check the authentication information.
    • Application Key
      • Application name: The name that identifies 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. Can copy value by clicking clovasummary-ico_01
      • Client Secret (X-NCP-APIGW-API-KEY): Enter "X-NCP-APIGW-API-KEY" in the header or query string as the SecretKey required for authentication. Copy the value by clicking clovasummary-ico_01, and change the value by clicking [Reissue].
    • Service environment
      • Web service URL: The value required to use web SDKs.
      • Android app package name: The value required to use Android SDKs.
      • iOS Bundle ID: The value required to use iOS SDKs.
  6. Click [OK].
Caution

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

Edit application.

To edit the registered application information:

  1. From the NAVER Cloud Platform console, navigate to i_menu > Services > AI·NAVER API > AI·NAVER API.
  2. Click the Application menu.
  3. Click [Edit] on the application you want to edit.
  4. Edit the necessary information, and then click [Save].

Manage usage

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

Check daily/monthly usage

To check the usage for the day and for the current month:

  1. From the NAVER Cloud Platform console, navigate to i_menu > Services > AI·NAVER API > AI·NAVER API.
  2. Click the Application menu.
  3. From the application list, check the real-time usage for the day and for the current month of the application for which you want to check the usage.
    • Based on UTC+9.
    • The daily usage is initialized to 0 at 00:00 AM (KST).
Note

It takes around 1 minute for the actual daily/monthly usage to be reflected.

Set usage limits

You can set up daily and monthly usage limits yourself to prevent excessive service usage fees from being charged. To set up a usage limit:

  1. From the NAVER Cloud Platform console, navigate to i_menu > Services > AI·NAVER API > AI·NAVER API.
  2. Click the Application menu.
  3. Click [Set limits and notifications] from the application list of the application that you want to edit the usage limit of.
    clovasummary-application_03_ko
  4. Enter the monthly and daily limit values under the [Set limits] tab menu.
    clovasummary-application_04_ko
  5. Click [Save].
Note

You can check the change history of usage limit under the Limit change history tab menu in the Set limits and notifications popup window.

Set threshold notifications

When a certain usage rate of the daily/monthly limit value set by the user is exceeded, you can receive notifications through email or SMS.
To set up a threshold notification:

  1. From the NAVER Cloud Platform console, navigate to i_menu > Services > AI·NAVER API > AI·NAVER API.
  2. Click the Application menu.
  3. Click [Set limits and notifications] from the application list of the application that you want to edit the usage limit of.
  4. Click the checkbox for the daily or monthly limit settings item under the [Set limits] tab menu.
  5. Select the threshold value (%) at which you want to be notified.
    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%.
  6. Click [Save].
  7. See Set notification recipients to enter the address at which you want to receive the threshold notifications.
Note

You will not receive notifications if you do not set notification recipients, even if you have set threshold notifications. Make sure to set notification recipients.

Set notification recipients

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, navigate to i_menu > Services > AI·NAVER API > AI·NAVER API.
  2. Click the Application menu.
  3. Click [Set limits and notifications] from the application list of the application that you want to edit the usage limit of.
  4. Click the [Set notification recipients] tab menu.
  5. Select a person to receive notifications and the notification method, and then click [Add].
    • To go to Cloud Insight (Monitoring) to add a new person, click [Manage notification recipients].
  6. Once you complete setting up the notification recipients, click [Save].
Note

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

Unsubscribe from the service

There is no separate procedure for unsubscribing from CLOVA Speech Recognition. If you delete the CLOVA Speech Recognition application, your application is successfully unsubscribed from. To delete the application:

  1. Access the NAVER Cloud Platform console.
  2. Click Region & Platform in the upper-right corner of the console interface.
  3. Select the region and platform you are using, and click [Apply].
  4. Click i_menu in the upper-left corner of the console interface.
  5. From the NAVER Cloud Platform console, navigate to **Services ** > AI·NAVER API ** > ** AI·NAVER API.
  6. Click the Application menu.
  7. Click the CLOVA Speech Recognition application that you wish to delete, then click [Delete].
  8. When the Delete app popup window appears, click [OK].