CLOVA Studioの概要

最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

Classic/VPC環境で利用できます。

CLOVA Studioは、超大規模(Hyperscale) AI技術である HyperCLOVA言語モデルを活用して、ユーザーが入力した内容に基づき AI技術によって生成された文言を出力する NAVERクラウドプラットフォームのサービスです。CLOVA Studioサービスでは、文の生成、チューニング、エクスプローラ、スキルトレーナー機能関連の APIを RESTful形式で提供します。

APIキー

CLOVA Studio APIは、権限を持つユーザーのみ呼び出すことができるようにユーザー識別ツールである APIキーをアカウントごとに発行しています。APIキーは、API呼び出し時の認証情報として渡すリクエストヘッダのパラメータとして使用します。そのため、CLOVA Studio APIを使用するには、先に APIキーを発行する必要があります。

APIキーの発行

APIキーは NAVERクラウドプラットフォームコンソールの CLOVA Studioで発行できます。発行方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールで Services > AI Services > CLOVA Studioメニューを順にクリックします。
2. 画面右上のユーザー名をクリックし、APIキーメニューをクリックします。
3. APIキー画面が表示されたら発行する APIキータブメニューをクリックし、発行ボタンをクリックします。
   • テスト APIキー: テストタブを選択 > テスト APIキーを発行
     • サービスアプリ以外の CLOVA Studio APIの呼び出し時に利用可能
   • サービス APIキー: サービスタブを選択 > サービス APIキーを発行
     • サービスアプリを含むすべての CLOVA Studio APIの呼び出し時に利用可能
4. APIキーの発行ポップアップが表示されたら、発行ボタンをクリックします。
   • APIキーのコピーポップアップから発行された APIキーをコピーします。
   注意

   発行された APIキーは、APIキーのコピーポップアップを閉じると確認できなくなります。発行時に必ず別の安全な場所に保管してください。

APIのセキュリティ設定

APIキーが第三者に流出する場合、CLOVA Studioリソースを任意に利用するなどセキュリティ上の深刻な問題が発生する可能性があるので、適切な事前準備と対応が必要です。

APIキーの削除と再発行

APIキーを使用していない場合や、第三者の盗用が疑われる場合は、発行した APIキーを削除し、再度発行する必要があります。削除および再発行方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールで Services > AI Services > CLOVA Studioメニューを順にクリックします。
2. 画面右上のユーザー名をクリックし、APIキーメニューをクリックします。
3. APIキー画面が表示されたら、削除対象の APIキーがあるタブメニューをクリックします。
4. 削除対象 APIキーのをクリックし、削除メニューをクリックします。
5. APIキーの削除ポップアップが表示されたら、 [削除] ボタンをクリックします。
6. APIキーの発行を参照して APIキーを新規発行します。

共通の設定

CLOVA Studio APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

テストアプリの作成

CLOVA Studio APIを使用するには、テストアプリまたはサービスアプリを作成する必要があります。アプリは NAVERクラウドプラットフォームコンソールで作成できます。詳細は、CLOVA Studioご利用ガイドをご参照ください。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

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

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

レスポンス

共通レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

レスポンス例

レスポンスのサンプルコードは次の通りです。

• 成功

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

• 失敗(クライアントエラー)

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

• 失敗(サーバエラー)

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

CLOVA Studio API

CLOVA Studioで提供する APIは次の通りです。

CLOVA Studio関連リソース

CLOVA Studio APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

• CLOVA Studio APIの使用方法
  • APIの概要: NAVERクラウドプラットフォームから発行された Access Key、Secret Keyの発行と確認、リクエストヘッダに必要な署名の作成方法
  • Sub Accountご利用ガイド: NAVERクラウドプラットフォームコンソールから発行されたサブアカウントの Access Key発行と確認方法
• CLOVA Studioサービスの使用方法
  • CLOVA Studioご利用ガイド: NAVERクラウドプラットフォームコンソールで CLOVA Studioを使用する方法
  • Ncloud使用環境ガイド: VPC、Classic環境とサポートの有無に関するご利用ガイド
  • 料金の紹介、特徴、詳細機能: CLOVA Studioの料金体系、CLOVA Studioの特徴と詳細機能、活用例のサマリー
  • サービス関連の最新のお知らせ: CLOVA Studio関連の最新共有ニュース
  • お問い合わせ: ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ
  • CLOVA Studioフォーラム: CLOVA Studio関連のお知らせ、活用法、使用経験の共有、お問い合わせ