--- title: "CLOVA Studioの概要" slug: "ai-naver-clovastudio-summary" tags: ["CLOVA Studio", "overview"] updated: 2026-10-08T07:24:08Z published: 2026-10-08T07:24:08Z canonical: "api.ncloud-docs.com/ai-naver-clovastudio-summary" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 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クラウドプラットフォームコンソールにアクセスします。 2. コンソール画面右上にある **リージョン&プラットフォーム** ボタンをクリックします。 3. 利用中のリージョンとプラットフォームを選択し、 **[適用]** ボタンをクリックします。 4. コンソール画面左上にある **Menu**をクリックします。 5. **All Services** > **AI Services** > **CLOVA Studio**メニューを順にクリックします。 6. 画面左側の **APIキー**メニューをクリックします。 7. **APIキー**画面が表示されたら発行する APIキータブメニューをクリックし、発行ボタンをクリックします。 - テスト APIキー: **[テスト]** タブメニューをクリック > **[テスト APIキーを発行]** ボタンをクリック - サービスアプリ以外の CLOVA Studio APIの呼び出し時に利用可能 - NAVERクラウドプラットフォームメインアカウント基準で最大10個まで作成可能 - サービス APIキー: **[サービス]** タブメニューをクリック > **[サービス APIキーを発行]** ボタンをクリック - 登録完了したサービスアプリの CLOVA Studio APIの呼び出し時に利用可能 - NAVERクラウドプラットフォームメインアカウント基準で最大10個まで作成可能 8. **APIキーコピー**のポップアップが表示されたら、 **[発行]** ボタンをクリックします。 9. **[コピー]** ボタンをクリックした後、 **[完了]** ボタンをクリックします。 注意 **APIキーコピー**のポップアップを閉じると、発行した APIキーの確認はできなくなります。発行時に必ず別の安全な場所に保管してください。 ### 旧バージョン APIキーの確認 (Deprecated) 2025年1月以前に発行したテストアプリまたは登録したサービスアプリに対して発行した APIキーを確認することができます。 #### テストアプリ テストアプリの APIキーを確認する方法は次の通りです。 1. NAVERクラウドプラットフォームコンソールで **Menu** > **All Services** > **AI Services** > **CLOVA Studio**メニューを順にクリックします。 2. 画面左側の **APIキー**メニューをクリックします。 3. **APIキー**画面が表示されたら、 **[Deprecated]** タブメニューをクリックします。 4. ![i_clovastudio-more](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/i_clovastudio-more.png?sv=2026-02-06&spr=https&st=2026-10-30T10%3A27%3A20Z&se=2026-10-30T11%3A27%3A20Z&sr=c&sp=r&sig=36AZOkeE3xAq9bUoG9itCbvrGYZCDBnsENG3uJrZ6ek%3D)をクリックし、**コピー**メニューをクリックして APIキーを確認します。 5. 右上の **[API Gatewayキーを表示]** ボタンをクリックします。 6. **API Gatewayキー**のポップアップが表示されたら、API Gatewayキーを確認します。 注意 API Gatewayキーを再発行すると、以前のキーで利用していたテストアプリ、サービスアプリは直ちに利用できなくなります。影響度を確認し、事前対策を行った上で、必要な場合にのみ行ってください。 #### サービスアプリ サービスアプリの APIキーを確認する方法は次の通りです。 1. NAVERクラウドプラットフォームコンソールで **Menu** > **All Services** > **AI Services** > **CLOVA Studio**メニューを順にクリックします。 2. 画面左から**サービスアプリの申し込み**メニューをクリックします。 3. サービスアプリの**コードを表示**ボタンをクリックします。 4. **[既存]** タブメニューをクリックしてサービスアプリの旧バージョン APIキーを確認し、API Gatewayキーを確認します。 - APIキー: `X-NCP-CLOVASTUDIO-API-KEY` - API Gatewayキー: `X-NCP-APIGW-API-KEY` ### APIのセキュリティ設定 APIキーが第三者に流出する場合、CLOVA Studioリソースを任意に利用するなどセキュリティ上の深刻な問題が発生する可能性があるので、適切な事前準備と対応が必要です。 #### APIキーの削除と再発行 APIキーを使用していない場合や、第三者の盗用が疑われる場合は、発行した APIキーを削除し、再度発行する必要があります。削除および再発行方法は次の通りです。 1. NAVERクラウドプラットフォームコンソールで **Menu** > **All Services** > **AI Services** > **CLOVA Studio**メニューを順にクリックします。 2. 画面左側の **APIキー**メニューをクリックします。 3. **APIキー**画面が表示されたら、削除対象の APIキーがあるタブメニューをクリックします。 4. 削除対象 APIキーの![i_clovastudio-more](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/i_clovastudio-more.png?sv=2026-02-06&spr=https&st=2026-10-30T10%3A27%3A20Z&se=2026-10-30T11%3A27%3A20Z&sr=c&sp=r&sig=36AZOkeE3xAq9bUoG9itCbvrGYZCDBnsENG3uJrZ6ek%3D)をクリックし、**削除**メニューをクリックします。 5. **APIキーの削除**ポップアップが表示されたら、 **[削除]** ボタンをクリックします。 6. [APIキーの発行](/docs/ja/ai-naver-clovastudio-summary#API%ED%82%A4%EB%B0%9C%EA%B8%89)を参照して APIキーを新規発行します。 注意 削除した APIキーは有効ではないキーとして認識され、APIの呼び出しに使用できません。影響度を確認し、事前対策を行った上で、必要な場合にのみ行ってください。 ## 共通設定 CLOVA Studio APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。 参考 CLOVA Studio APIキーがある場合、すぐに CLOVA Studio APIを利用することができます。ただし、サービス APIキーでサービスアプリを利用するには、申し込みの手続きが別途必要です。申し込み方法の詳細は、[CLOVA Studioご利用ガイド](https://guide.ncloud-docs.com/docs/ja/clovastudio-playground01#%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%95%B1-%EC%83%9D%EC%84%B1)をご参照ください。 ### リクエスト 共通リクエスト形式を説明します。 #### API URL リクエスト API URLは次の通りです。 ``` https://clovastudio.stream.ntruss.com/ ``` 参考 旧バージョンのリクエスト API URL(`https://clovastudio.apigw.ntruss.com/`)も CLOVA Studio APIの呼び出しに使用できますが、サポート中断が予定されていますので、上記でご案内しました URLへの切り替えをお勧めします。旧バージョンのリクエスト API URLで呼び出すと、新規 APIキーによる認証ができず、生成トークンを1つずつ出力するストリーミングレスポンスを使用できません。 #### リクエストヘッダ リクエストヘッダの説明は次の通りです。 | フィールド | 必須の有無 | 説明(例) | | --- | --- | --- | | `Authorization` | Required | 認証用 APIキー - 例) `Bearer nv-************` | | `X-NCP-CLOVASTUDIO-REQUEST-ID` | Optional | リクエスト ID | | `Content-Type` | Required | リクエストデータの形式 - `application/json` | | `Accept` | Conditional | レスポンスデータの形式 - `text/event-stream` | 参考 レスポンス結果は基本的に JSON形式で返されますが、`Accept`を`text/event-stream`に指定するとレスポンス結果をストリーム形式で返します。 ### レスポンス 共通レスポンス形式を説明します。 #### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `status` | Object | - | レスポンスステータス | | `status.code` | String | - | [レスポンスステータスコード](/docs/ja/clovastudio-troubleshoot)を参照 | | `status.message` | String | - | レスポンスメッセージ | | `result` | Any | - | レスポンス結果 | 参考 レスポンスステータスコード別原因と解決方法は、[CLOVA Studioのトラブルシューティング](/docs/ja/clovastudio-troubleshoot)をご参照ください。 #### レスポンス例 レスポンスのサンプルコードは次の通りです。 - 成功 ``` { "status": { "code": "20000", "message": "OK" }, "result": {} } ``` - 失敗 ``` { "status": { "code": "50000", "message": "Internal Server Error" } } ``` - 失敗 (オープン AI互換性) ``` { "error": { "message": "Internal Server Error", "type": null, "param": null, //サポートしていない "code": "50000" } } ``` ## CLOVA Studio API CLOVA Studioで提供する APIは次の通りです。 | API | 説明 | | --- | --- | | [Chat Completions v3 (テキストと画像)](/docs/ja/clovastudio-chatcompletionsv3) | ビジョン/言語モデルを利用した画像解析または会話型文章を生成 | | [Chat Completions v3 (推論(Thinking))](/docs/ja/clovastudio-chatcompletionsv3-thinking) | ユーザークエリの分析と論理的思考による推論を通じて最終回答を生成 | | [Chat Completions v3 (Fuction calling)](/docs/ja/clovastudio-chatcompletionsv3-fc) | 外部関数や APIを呼び出して動的に情報を取得したり、操作を実行することができる Function calling | | [Chat Completions v3 (Structured Outputs)](/docs/ja/clovastudio-chatcompletionsv3-so) | 目的の JSON Schema形式の出力結果を生成できる Structured Outputs | | [Chat Completions](/docs/ja/clovastudio-chatcompletions) | HyperCLOVA Xモデルを利用して会話型文章を生成 | | [オープン AI互換性](/docs/ja/clovastudio-openaicompatibility) | 主要 APIに対するオープン AI SDKと API互換性を提供 | | [学習の照会](/docs/ja/clovastudio-gettask) | 学習状況を照会 | | [学習リストの照会](/docs/ja/clovastudio-gettasks) | 作成した学習リストを照会 | | [学習の作成](/docs/ja/clovastudio-posttask) | ユーザーのデータセットを使用した学習を作成 | | [学習の削除](/docs/ja/clovastudio-deletetask) | 作成した学習を削除 | | [リランカー](/docs/ja/clovastudio-reranker) | ユーザークエリと関連性の高い検索文書を活用した RAG回答を生成 | | [RAG Reasoning](/docs/ja/clovastudio-ragreasoning) | RAG Reasoningモデルを活用した根拠に基づく回答を生成 | | [トークン計算機(チャット)](/docs/ja/clovastudio-tokenizerhcx) | HCXモデル(Chat Completions API)で入力した文章のトークン数を計算 | | [トークン計算機(チャット v3)](/docs/ja/clovastudio-tokenizerhcxv3) | HCXモデル(Chat Completions v3 API)で入力した文章と画像のトークン数を計算 | | [トークン計算機(エンベディング v2)](/docs/ja/clovastudio-tokenizerembedding) | エンベディング v2で入力した文章のトークン数を計算 | | [スライディングウィンドウ](/docs/ja/clovastudio-sliding) | Chat Completions利用時、最大トークン数を超える文章を処理 | | [サマリー](/docs/ja/clovastudio-summarization) | さまざまなオプションを適用して長文を要約 | | [エンベディング](/docs/ja/clovastudio-embedding) | テキストを数字で表現するベクトル化を実行 | | [エンベディング v2](/docs/ja/clovastudio-embeddingv2) | 長文テキストを数字で表現するベクトル化を実行 | | [段落分け](/docs/ja/clovastudio-segmentation) | 文章間の類似度を把握してテーマ単位で文章の段落を区切る | | [ルーター](/docs/ja/clovastudio-router) | ユーザー入力に対してドメインとフィルタの判別を行う | | [スキルセット](/docs/ja/clovastudio-generateskillsetfinalanswer) | スキルセット APIを呼び出して回答を生成 | ## CLOVA Studio関連リソース CLOVA Studio APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。 - CLOVA Studio APIの使用方法 - [APIの概要](/docs/ja/common-ncpapi): NAVERクラウドプラットフォームから発行された Access Key、Secret Keyの発行と確認、リクエストヘッダに必要な署名の作成方法 - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): NAVERクラウドプラットフォームコンソールから発行されたサブアカウントの Access Key発行と確認方法 - CLOVA Studioサービスの使用方法 - [CLOVA Studioご利用ガイド](https://guide.ncloud-docs.com/docs/ja/clovastudio-overview): NAVERクラウドプラットフォームコンソールで CLOVA Studioを使用する方法 - [Ncloud利用環境ガイド](https://guide.ncloud-docs.com//docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/aiService/clovaStudio): CLOVA Studioの料金体系、CLOVA Studioの特徴と詳細機能、活用例のサマリー - [サービスの最新情報](https://www.ncloud.com/intro/news): CLOVA Studioに関する最新情報 - [お問い合わせ](https://www.ncloud.com/support/question/service): ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ