カテゴリ:

:doc:`/sql-reference/functions-string`(AI 関数)

COUNT_TOKENS (SNOWFLAKE.CORTEX)

引数で指定された大規模言語モデルまたはタスク固有の関数のプロンプトのトークン数を返します。この関数は微調整済みモデルをサポートしていません。

注釈

ai_classifyやai_filterなどの関数の、より正確なトークン数の推定に努めています。

構文

SNOWFLAKE.CORTEX.COUNT_TOKENS( <model_name> , <input_text> )
Copy

引数

必須:

model_name

トークン数の基にしたいモデルの名前。次の値のいずれかを指定します。

  • deepseek-r1

  • e5-base-v2

  • e5-large-v2

  • gemma-7b

  • jamba-1.5-large

  • jamba-1.5-mini

  • jamba-instruct

  • llama2-70b-chat

  • llama3-70b

  • llama3-8b

  • llama3.1-405b

  • llama3.1-70b

  • llama3.1-8b

  • llama3.2-1b

  • llama3.2-3b

  • llama3.3-70b

  • llama4-maverick

  • llama4-scout

  • mistral-7b

  • mistral-large

  • mistral-large2

  • mixtral-8x7b

  • nv-embed-qa-4

  • reka-core

  • reka-flash

  • snowflake-arctic-embed-l-v2.0

  • snowflake-arctic-embed-m-v1.5

  • snowflake-arctic-embed-m

  • snowflake-arctic

  • snowflake-llama-3.1-405b

  • snowflake-llama-3.3-70b

  • voyage-multilingual-2

input_text

トークンを数えるテキストを入力。

戻り値

指定されたモデルまたは関数に基づいて、入力テキスト内のトークン数を INT , INTEGER , BIGINT , SMALLINT , TINYINT , BYTEINT 型で返します。

使用上の注意

  • 関数名が指定された場合、トークン数はその関数が使用するモデルに基づいてカウントされます。

  • 関数名には小文字を使用します。

注釈

COUNT_TOKENS には、Cortex AISQL 関数 を使用する際に入力テキストの先頭に自動的に追加される管理システムプロンプトは含まれません。その結果、 COUNT_TOKENS によって返される値は、これらの関数によって処理された実際のトークン数よりも少なくなります。

次の例では、llama3.1-70b モデルを使用して指定されたプロンプトのトークン数を返しています。

SELECT SNOWFLAKE.CORTEX.COUNT_TOKENS( 'llama3.1-70b', 'what is a large language model?' );
Copy
+---+
| 6 |
+---+