CLOVA Studio 使用料制限ポリシー

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

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

CLOVA Studioはユーザーが特定時間内に使用できる APIリクエスト数とトークン数に制限を設けています。これを使用料制限ポリシーと呼び、サービスの可用性を保ち安定性と確保するために必要なポリシーです。ユーザーは決められたスコープ内で CLOVA Studioサービスを利用でき、リクエスト可能な最大値を超過する場合はエラーメッセージやエラーコードが返されます。
使用料制限ポリシーを適用するとこで悪意を持って APIを多量呼び出して攻撃する行為を防ぐことができ、過剰なトラフィックからサービスを保護できます。また特定ユーザーがリソースを独占することを防ぎ、すべてのユーザーがリソースを安定的に使用できる環境を構成できます。モデル、ツール、目的に応じて使用できる最大値が変わるため、このガイドで案内する内容を必ず熟知してください。

適用基準

最大使用量を算定時に基準となる対象は、次の通りです。

最大使用量

CLOVA Studioで使用量が制限される数値は、1分当たりのリクエスト回数である QPMと1分当たりの処理トークン数を意味する TPMです。QPMと TPMがすべて適用される場合、2つの値のうち1つでも最大値に達するとエラーコードが返されます。
QPMと TPMに関する説明は、次の通りです。

CLOVA Studioウェブおよびテストアプリ

CLOVA Studioプレイグラウンドとテストアプリで利用できる最大の QPM、TPMを説明します。

モデル別最大使用量

モデル別に使用できる最大 QPM、TPMは、次の通りです。

サービスアプリ

サービスアプリでモデル別、ツール別に利用できる最大 QPMと TPMを説明します。
サービスアプリの使用可能な最大 QPM、TPMの計算時にウェブおよびテストアプリの最大使用量も含まれます。したがって明示された最大値で使用するには、サービスアプリとテストアプリを同時に運用する必要があり、サービスアプリを単独で運用する場合はテストアプリの最大使用量を差し引いた値が適用されます。

モデル別最大使用量

モデル別に使用できる最大 QPM、TPMは、次の通りです。

最大使用量の管理

CLOVA Studioサービス利用時にリクエストできる最大値を超過した場合、HTTP 429コードが返されたり、エラーメッセージが表示されたりします。最大使用量を超過しないために実行できるタスクを説明します。

QPM管理方法

• QPM数値を予め確認した後、最大値以内でリクエストします。
• 別途の API呼び出しコントロール機能(rate limit)を直接実現および追加します。
• リクエスト間に一定時間の遅延処理機能(time sleep)を別途追加します。
• HTTP 429コードが返されて、当該エラーメッセージに対してレスポンスする時に、例外処理を通じて一定時間が経った後に再度リクエストします。

TPM管理方法

• TPM数費を予め確認し、タスクのために入力するトークン数と結果値の作成時に使用する最大トークン分割を実際に必要な分だけ設定します。
• API呼び出し時に入力した文字列のトークン数を確認するには、 エクスプローラー メニューのトークン計算機 APIを活用します。
• API呼び出し時に結果値に使用する最大トークン数を調整するには、maxTokens フィールドの値を編集します。
• プレイグラウンド メニューで入力された文字列のトークン数を確認するには、プレイグラウンド画面上部の計算 アイコンをクリックします。
  
• プレイグラウンド メニューで結果値を作成する時に使用する最大トークン数を調整するには、プレイグラウンド画面左側の Maximum tokens フィールドを編集します。