CLOVA Studio overview

Available in Classic and VPC

CLOVA Studio is a NAVER Cloud Platform service that utilizes the HyperCLOVA language model, a hyperscale AI technology, to output phrases generated by AI technology based on user input. The CLOVA Studio service provides APIs for sentence generation, tuning, explorer, and skill trainer features in RESTful form.

API key

The CLOVA Studio API issues an API key, a user identification tool, to each account so that only authorized users can call it. The API key is used as a parameter in the request header that is passed as authentication information when calling the API. Therefore, to use the CLOVA Studio API, you must first obtain an API key.

Issue API key

API keys can be issued in CLOVA Studio in the NAVER Cloud Platform console. The following describes how to issue them.

1. In the NAVER Cloud Platform console, click Services > AI Services > CLOVA Studio menus, in that order.
2. Click on your username in the top right corner of the page, and then click then API key menu.
3. When the API key page appears, click the tab menu of the API key you want to issue, and then click the Issue button.
   • Test API key: Select Test tab > Issue test API key
     • Available when calling CLOVA Studio APIs except for service apps
   • Service API key: Select Service tab > Issue service API key
     • Available when calling CLOVA Studio APIs including service apps
4. When the Issue API key pop-up window appears, click the Issue button.
   • In the Copy API key pop-up window, copy the issued API key.
   Caution

   The issued API key cannot be verified after the Copy API key pop-up window is closed. Therefore, be sure to store it in a separate safe space at the time of issuance.

Set API security

If the API key is leaked to a third party, security issues may arise, such as unauthorized use of CLOVA Studio resources, so proper preparation and response are required.

Delete and reissue API key

If you do not use the API key or suspect that it has been stolen by a third party, you must delete the issued API key and reissue it. The following describes how to delete and reissue the API key.

1. In the NAVER Cloud Platform console, click Services > AI Services > CLOVA Studio menus, in that order.
2. Click on your username in the top right corner of the page, and then click then API key menu.
3. When the API key page appears, click the tab menu where the API key to delete is located.
4. Click of the API key to delete, and click the Delete menu.
5. When the Delete API key pop-up window appears, click the [Delete] button.
6. See Issue API key and issue a new API key.

Common attributes

The following describes commonly used request and response formats in CLOVA Studio APIs.

Create test app

If you want to use CLOVA Studio APIs, then you must create a test or service app first. These apps can be created in the NAVER Cloud Platform console. For more information, see CLOVA Studio User Guide.

Request

The following describes the common request format.

API URL

The request API URL is as follows.

https://clovastudio.stream.ntruss.com/

Request headers

The following describes the request headers.

Response

The following describes the common response format.

Response body

The response body includes the following data:

Response example

The response example is as follows:

• Succeeded

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

• Failure (client error)

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

• Failure (server error)

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

CLOVA Studio API

The APIs provided by CLOVA Studio are as follows.

CLOVA Studio related resources

NAVER Cloud Platform provides a variety of related resources to help users better understand CLOVA Studio APIs.

• CLOVA Studio API guides
  • API overview: how to issue and check access key and secret key issued by NAVER Cloud Platform, how to generate the signature required for request headers
  • Sub Account User Guide: how to issue and check access keys for sub accounts issued by NAVER Cloud Platform
• How to use the CLOVA Studio service
  • CLOVA Studio User Guide: how to use CLOVA Studio in the NAVER Cloud Platform console
  • Ncloud use environment guide: guide on VPC and Classic environments and supported features
  • Introduction to pricing, characteristics, and detailed features: summary of CLOVA Studio pricing system, characteristics, detailed features, and utilization examples of CLOVA Studio
  • Latest service news: the latest news on CLOVA Studio
  • Contact us: Send direct inquiries in case of any unresolved questions that aren't answered by the user guides.
  • CLOVA Studio forum: CLOVA Studio related announcements, how-to's, user experience sharing, and support inquiries