CLOVA Studio の概要
    • PDF

    CLOVA Studio の概要

    • PDF

    Article Summary

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

    ハイパースケール(Hyperscale)の AI技術である HyperCLOVA言語モデルを活用し、ユーザーが入力した内容に応じて AI技術によって作成されたフレーズを出力する NAVERクラウドプラットフォームのサービスです。

    オペレーション

    CLOVA Studioが提供するオペレーションは、次の通りです。

    API説明
    Chat CompletionsHyperCLOVA 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で共通に使用するレスポンス形式について説明し、構文例をご案内します。

    ボディ

    ボディの説明は次の通りです。

    フィールドタイプ必須有無説明
    statusobjectNレスポンス状態
    status.codestringNレスポンス状態コード
    status.messagestringNレスポンスメッセージ
    resultanyYレスポンス結果

    レスポンス状態コード

    レスポンス状態コードについて説明します。

    HTTP状態コードコードメッセージ説明
    20020000OKリクエスト処理に成功
    20420400No contentリクエスト処理に成功、コンテンツを返さない
    40040000Bad request不正なリクエスト
    40040001Invalid parameter不正なリクエストパラメータ
    40040003Text to longリクエストテキストが長すぎる
    40040004Text empty空白のテキストでリクエスト
    40040005Unavailable output 1結果を提供できないリクエスト
    40040006Unavailable output 2結果を提供できないリクエスト
    40040009Unsupported functionサポートしない機能リクエスト
    40040010input_text_emptyスキル: query(クエリ)、thought(思考)、action(アクション)、actionInput(アクション入力)、observe(監視)パラメータを空欄でリクエスト
    40040020missing_input_valueスキル: 入力値が一部欠落
    40040030invalid Actionスキル: 定義されていない action(アクション)を入力
    40040040invalid Action Inputスキル: 不正な actionInput(アクション入力)を入力
    40040050internal parsing errorスキル: 内部パースエラー
    40040080model not foundモデルが見つからない
    40140100Unauthorized認証失敗
    40140101Invalid signature不正なリクエスト署名
    40140102Invalid access tokenアクセストークンの有効期限切れ
    40140103Access token expiredサーバタスク拒否
    40140104Invalid key無効な認証キー
    40140170No subscription request history found. Please request a subscription to useCLOVA Studioご利用の申し込み履歴が見つからない
    40340300Forbiddenサーバタスク拒否
    40340301No ownership所有権なし
    40440400Not foundリクエストしたリソースが見つからない
    40640600Not Acceptable不正なメディア形式
    40840800Request timeoutリクエスト処理の時間超過
    41541500MediaType error対応していないメディア形式
    41541501No multipart boundary Content-Typemultipartの使用が必要だが、形式に合わないリクエスト
    42942900Too many requestsリクエストが多すぎる
    42942901Too many requests - rate exceededリクエストが多すぎる(最大利用量超過)
    42942902Too many requests - overloadedリクエストが多すぎる(トラフィック過多)
    50050000Internal server error内部サーバエラー
    50050010no final answerスキル: API呼び出し時に final_answerが欠落
    50051010プランニング可能なツールがありません。スキル: プランニング可能なツールなし
    50051020プランニング中に不明なエラーが発生しました。 {reason}スキル: プランニング中に不明なエラーが発生
    50051030与えられたクエリに対してプランニングができません。理由は次の通りです。 {reason}スキル: プランニングタスク拒否
    50052020jsonの作成が間違っています。回答できません。スキル: ディスクリミネータで LLMが判断した結果を json parsingする際にエラーが発生
    50052030skillSetの作成が間違っています。回答できません。スキル: ディスクリミネータで作成した skillSetが入力した skillSetに存在しない場合
    50053010検索 API parsingに失敗しました。スキル: 検索 APIの結果を前処理する際にエラーが発生
    50053020原文の長さが短いため要約できません。スキル: 原文が char_size基準に100文字未満の場合にエラーが発生
    50060000HyperCLOVA API Error url:{url}スキル: HyperCLOVA関連エラー
    50064000{HyperCLOVA error message}スキル: HyperCLOVA入力関連エラー(text too longなど)
    50064240{HyperCLOVA error message}スキル: HyperCLOVA作成関連エラー(lora urlの問題など)
    50064290{HyperCLOVA error message}スキル: HyperCLOVA too many requestsエラー
    50065000{HyperCLOVA error message}スキル: HyperCLOVA internal server error
    50150100Not yet implemented実装されていない APIの呼び出し
    50450400Gateway timeoutゲートウェイ処理の時間超過
    参考

    上記状態コード以外の NAVERクラウドプラットフォームの共通状態コードは、NAVER連携 APIでご確認ください。

    構文

    共通レスポンスの構文例をご案内します。

    • 成功
      {
        "status": {
          "code": "20000",
          "message": "OK"
        },
        "result": {}
      }
      
    • 失敗(クライアントエラー)
      {
      "status": {
      "code": "40102",
      "message": "Invalid access token"
          }
      }
      
    • 失敗(サーバエラー)
      {
      "status": {
      "code": "50000",
      "message": "Internal Server Error"
          }
      }
      

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.