CLOVA Studio の概要
- 印刷する
- PDF
CLOVA Studio の概要
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Classic/VPC環境で利用できます。
ハイパースケール(Hyperscale)の AI技術である HyperCLOVA言語モデルを活用し、ユーザーが入力した内容に応じて AI技術によって作成されたフレーズを出力する NAVERクラウドプラットフォームのサービスです。
オペレーション
CLOVA Studioが提供するオペレーションは、次の通りです。
API | 説明 |
---|---|
Chat Completions | HyperCLOVA Xモデルを活用した会話型文章を作成 |
Completions | 文章作成 |
学習作成 | ユーザーのデータセットを使用した学習を作成 |
学習照会 | 作成した学習1件の情報を照会 |
学習リスト照会 | 作成した学習リストを照会 |
学習モデル Chat Completions | 学習モデルを活用した会話型文章を作成 |
スキルセット回答作成 | スキルセット API呼び出しで回答を作成 |
参考
CLOVA Studioが提供するエクスプローラ関連の API明細は、CLOVA Studioのウェブで確認できます。
共通設定
CLOVA Studio APIで共通に使用する形式や設定について説明します。
テストアプリ作成
テストアプリを作成すると、APIを使用できます。
リクエスト
CLOVA Studio APIで共通に使用するリクエスト形式について説明します。
API URL
リクエスト API URLは、次の通りです。
https://clovastudio.apigw.ntruss.com/
参考
Chat completionsでストリーミングレスポンスを利用する場合、別の API URLを使用する必要があります。以下の内容をご参照ください。
レスポンス
CLOVA Studio APIで共通に使用するレスポンス形式について説明し、構文例をご案内します。
ボディ
ボディの説明は次の通りです。
フィールド | タイプ | 必須有無 | 説明 |
---|---|---|---|
status | object | N | レスポンス状態 |
status.code | string | N | レスポンス状態コード |
status.message | string | N | レスポンスメッセージ |
result | any | Y | レスポンス結果 |
レスポンス状態コード
レスポンス状態コードについて説明します。
HTTP状態コード | コード | メッセージ | 説明 |
---|---|---|---|
200 | 20000 | OK | リクエスト処理に成功 |
204 | 20400 | No content | リクエスト処理に成功、コンテンツを返さない |
400 | 40000 | Bad request | 不正なリクエスト |
400 | 40001 | Invalid parameter | 不正なリクエストパラメータ |
400 | 40003 | Text to long | リクエストテキストが長すぎる |
400 | 40004 | Text empty | 空白のテキストでリクエスト |
400 | 40005 | Unavailable output 1 | 結果を提供できないリクエスト |
400 | 40006 | Unavailable output 2 | 結果を提供できないリクエスト |
400 | 40009 | Unsupported function | サポートしない機能リクエスト |
400 | 40010 | input_text_empty | スキル: query(クエリ)、thought(思考)、action(アクション)、actionInput(アクション入力)、observe(監視)パラメータを空欄でリクエスト |
400 | 40020 | missing_input_value | スキル: 入力値が一部欠落 |
400 | 40030 | invalid Action | スキル: 定義されていない action(アクション)を入力 |
400 | 40040 | invalid Action Input | スキル: 不正な actionInput(アクション入力)を入力 |
400 | 40050 | internal parsing error | スキル: 内部パースエラー |
400 | 40080 | model not found | モデルが見つからない |
401 | 40100 | Unauthorized | 認証失敗 |
401 | 40101 | Invalid signature | 不正なリクエスト署名 |
401 | 40102 | Invalid access token | アクセストークンの有効期限切れ |
401 | 40103 | Access token expired | サーバタスク拒否 |
401 | 40104 | Invalid key | 無効な認証キー |
401 | 40170 | No subscription request history found. Please request a subscription to use | CLOVA Studioご利用の申し込み履歴が見つからない |
403 | 40300 | Forbidden | サーバタスク拒否 |
403 | 40301 | No ownership | 所有権なし |
404 | 40400 | Not found | リクエストしたリソースが見つからない |
406 | 40600 | Not Acceptable | 不正なメディア形式 |
408 | 40800 | Request timeout | リクエスト処理の時間超過 |
415 | 41500 | MediaType error | 対応していないメディア形式 |
415 | 41501 | No multipart boundary Content-Type | multipartの使用が必要だが、形式に合わないリクエスト |
429 | 42900 | Too many requests | リクエストが多すぎる |
429 | 42901 | Too many requests - rate exceeded | リクエストが多すぎる(最大利用量超過) |
429 | 42902 | Too many requests - overloaded | リクエストが多すぎる(トラフィック過多) |
500 | 50000 | Internal server error | 内部サーバエラー |
500 | 50010 | no final answer | スキル: API呼び出し時に final_answerが欠落 |
500 | 51010 | プランニング可能なツールがありません。 | スキル: プランニング可能なツールなし |
500 | 51020 | プランニング中に不明なエラーが発生しました。 {reason} | スキル: プランニング中に不明なエラーが発生 |
500 | 51030 | 与えられたクエリに対してプランニングができません。理由は次の通りです。 {reason} | スキル: プランニングタスク拒否 |
500 | 52020 | jsonの作成が間違っています。回答できません。 | スキル: ディスクリミネータで LLMが判断した結果を json parsingする際にエラーが発生 |
500 | 52030 | skillSetの作成が間違っています。回答できません。 | スキル: ディスクリミネータで作成した skillSetが入力した skillSetに存在しない場合 |
500 | 53010 | 検索 API parsingに失敗しました。 | スキル: 検索 APIの結果を前処理する際にエラーが発生 |
500 | 53020 | 原文の長さが短いため要約できません。 | スキル: 原文が char_size基準に100文字未満の場合にエラーが発生 |
500 | 60000 | HyperCLOVA API Error url:{url} | スキル: HyperCLOVA関連エラー |
500 | 64000 | {HyperCLOVA error message} | スキル: HyperCLOVA入力関連エラー(text too longなど) |
500 | 64240 | {HyperCLOVA error message} | スキル: HyperCLOVA作成関連エラー(lora urlの問題など) |
500 | 64290 | {HyperCLOVA error message} | スキル: HyperCLOVA too many requestsエラー |
500 | 65000 | {HyperCLOVA error message} | スキル: HyperCLOVA internal server error |
501 | 50100 | Not yet implemented | 実装されていない APIの呼び出し |
504 | 50400 | Gateway timeout | ゲートウェイ処理の時間超過 |
参考
上記状態コード以外の NAVERクラウドプラットフォームの共通状態コードは、NAVER連携 APIでご確認ください。
構文
共通レスポンスの構文例をご案内します。
- 成功
{ "status": { "code": "20000", "message": "OK" }, "result": {} }
- 失敗(クライアントエラー)
{ "status": { "code": "40102", "message": "Invalid access token" } }
- 失敗(サーバエラー)
{ "status": { "code": "50000", "message": "Internal Server Error" } }
この記事は役に立ちましたか?