Cloudflare: Clef Flash
Cloudflare Clef Flashは、迅速な分類とワークフロー上の選択のために設計された、Clef判断モデル群の小型9Bモデルです。テキスト、構造化された状態、視覚入力を名前付きの質問に照らして評価し、文章を生成せずに、選択肢ごとの確率、選択されたカテゴリ、または順序付きのスコアを返します。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Cloudflare Clef Flashは、視覚エンコーダーを備えたQwen3.5-9Bを追加学習して構築した、Clefモデル群の小型判断モデルです。共同スキーマヘッドが入力から証拠を読み取り、要求されたすべての質問について、許可された回答を1回の順伝播で採点します。その役割は、ワークフロー内で定義された範囲内の分類と判断を生成することです。出力は、アプリケーションがカテゴリとして解釈しなければならない会話の回答ではなく、確率を伴う型付きの結果です。
テキストまたはJSONの状態として状況を記述し、質問は別に定義します。質問には一貫した名前、型、明確な指示が必要です。カテゴリを選ぶ質問やスコアを付ける質問では、許可する基準も定義します。サポートメッセージなら、ある質問で問題を分類し、別の質問で緊急度を評価し、さらに別の質問で次の工程に必要な情報がレコードに欠けているかを判定できます。判断を証拠に結び付けるため、顧客の実際の表現、関連する履歴、運用ルールを状態に含めてください。
3種類の質問は、それぞれ異なる要件に対応します。noulの結果は、真偽条件が成り立つ確率です。choiceの結果は、名前付きの選択肢を1つ特定し、ほかの選択肢も含めた確率と信頼度を含みます。scoreの結果は、順序付きの基準を評価し、確率加重スコア、凡例、分布を返します。スコアの順序は意図を持って定義してください。「対応不要」から「即時確認」へと進む順序と、順序のないトピックラベルの集合とでは意味が異なります。
迅速な振り分けでは、カテゴリ間の違いを実際に決める行動や担当範囲を使ってカテゴリを説明します。たとえば、アカウントへのアクセス、技術的な不具合、ドキュメントへの質問、その他を選択肢とし、それぞれに説明を付けたリクエストが有用です。モデルの結果は、アプリケーションの振り分けルールへ渡せます。技術的な不具合とアカウントへのアクセスの確率が近い場合、それは曖昧さを示す有用な証拠です。選択されたラベルを確定診断とみなすのではなく、そのようなケースをワークフローでどう扱うかを明示的に決めてください。
視覚的な分類では、判読できる画像と、その画像が裏付けられる条件を入力します。領収書の確認なら、合計金額が読めるかを問い、定義済みの書類品質カテゴリから選ぶことができます。モデルを無制限な情報抽出や文章作成サービスのように扱い、任意の新しい合計金額を要求するべきではありません。メーカーのオープンウェイト用インターフェースは、動画フレームの配列も受け付けます。フレームと文章で記述した状態とのつながりを維持し、その資料内で見える事象や条件について質問してください。
現行のメーカーのホステッド参照仕様には、24,576トークンのコンテキスト、最大64件の質問、最大4枚の埋め込み画像が記載されています。PNG、JPEG、WebP画像は1枚あたり4 MiB、16メガピクセルが上限で、デコード後の合計は8 MiBです。リクエスト本文全体の上限は13 MiBで、リモート画像リンクは受け付けません。質問定義とメディアは入力領域を消費し、長いテキストは収まるように切り詰められる場合があります。判断に必要な証拠をコンパクトな状態にまとめてください。Cloudflareは、ホステッド環境のコンテキストを縮小しても公開済みのウェイトは変更しなかったと説明しています。このため、ホステッド環境のウィンドウとオープンウェイトの設定は別のものとして扱う必要があります。
モデルの制約された出力は、ポリシーやワークフローの確認を繰り返す用途に適しています。たとえば、レコードが指定した完全性のルールを満たすか、どのフォローアップカテゴリに該当するかを、別々の質問として定義できます。基準を明示し、ワークフローの設計に含まれる場合は、カテゴリで扱い切れないケースのための選択肢も用意してください。確率は入力された選択肢を採点するものであり、それらの選択肢が現実のあらゆる状況を完全に記述していると証明するものではありません。
状態、スキーマ、返された回答をまとめて保持してください。結果が予想と異なる場合は、基準が曖昧ではないか、決定的な入力が欠けていないか、関連するテキストが切り落とされていないかを調べます。自動処理のしきい値を決める前に、実際のタスクで確認済みのケースとモデルの評価を比較してください。Clef Flashが小型で高速な判断向けと位置付けられていても、そのワークフローで誤った振り分けが生じた場合の損失を確認する必要はなくなりません。
型付きの結果を、アプリケーションの次の工程への入力として使います。モデルはその工程を実行せず、その工程で最終的に必要となる説明文も書きません。ユーザーが報告書を必要とする場合は、判断と元の証拠を別の文章作成処理で利用できるようにしてください。Clef Flashから得られる有用な成果物は、名前付きの各質問に対する点検可能な回答と、ワークフローのルールを適用するために必要な確率情報です。
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-flash
cloudflare/clef-flashはじめに
Cloudflare Clef Flashは、迅速な分類とワークフロー上の選択のために設計された、Clef判断モデル群の小型9Bモデルです。テキスト、構造化された状態、視覚入力を名前付きの質問に照らして評価し、文章を生成せずに、選択肢ごとの確率、選択されたカテゴリ、または順序付きのスコアを返します。
- 対応する入力
- テキスト · 画像
- 結果
- decisions
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · System One POST /v1/systemone
- 入力の種類
text,image- 出力の種類
decisions- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 cloudflare/clef-flash | デフォルト— |
フィールドprovider | 種類schema | 要件任意 | 値と制限 | デフォルト— |
フィールドquestions | 種類object | 要件必須 | 値と制限 | デフォルト— |
フィールドsession_id | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドstate | 種類schema | 要件必須 | 値と制限 | デフォルト— |
フィールドtrace | 種類schema | 要件任意 | 値と制限 | デフォルト— |
フィールドuser | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドquestions.<id>.type | 種類string | 要件必須 | 値と制限 noul, choice, score | デフォルト— |
フィールドquestions.<id>.instructions | 種類string|object|array | 要件必須 | 値と制限 | デフォルト— |
フィールドquestions.<id>.criteria | 種類object|array | 要件任意 | 値と制限 条件: choice/score:必須;noul:任意。choiceのcriteriaはオブジェクト、scoreはminItems1の配列です。 | デフォルト— |
フィールドquestions.<id>.criteria.true | 種類string|object|array | 要件必須 | 値と制限 適用条件: noul の条件オブジェクトが指定されている | デフォルト— |
フィールドquestions.<id>.criteria.false | 種類string|object|array | 要件必須 | 値と制限 適用条件: noul の条件オブジェクトが指定されている | デフォルト— |
入力素材の組み合わせ
noul · 必須: state, questions.<id>.type=noul, questions.<id>.instructions
choice · 必須: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · 必須: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, state, questions |
パラメータmaterial_types | 仕様text, image |
パラメータoptional_controls | 仕様provider, session_id, trace, user |
パラメータmultimodal_input_binding | 仕様宣言された正確な状態/文書の表現形式だけを使用してください。メーカーが画像に対応していることだけでは、モデル固有の受け入れ可能な画像の受け渡し形式が確定するわけではありません。 |
ライフサイクル: synchronous
正確なモデルIDを送信し、ネイティブのレスポンス全体を保持してください。
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値(default)を使用する場合
Ailootの料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | コンテキストトークン数が次の値を超える場合 | コンテキストトークン数が次の値以下の場合 | 料金 |
|---|---|---|---|---|
| 設定トークンの基本単価 | 料金表基本料金 | コンテキストトークン数が次の値を超える場合— | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $0.000076 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定リクエスト長に応じた料金区分 1 | 料金表— | コンテキストトークン数が次の値を超える場合0 | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $0.000076 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · System One
{
"model": "cloudflare/clef-flash",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cloudflare/clef-flash'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
結果を受け取って保存
Ailoot Ultra · System One
json
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
指定された各質問IDに対する回答は、正確な型、noul/choice/scoreの値、信頼度、確率、凡例とともにすべて保持されます。元のJSON全体は保存され、精算後にのみ返されます。
元のレスポンスを確認する場合
元の操作と、完全または部分的な応答を保持してください。POSTを再実行しないでください。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドmodel | 種類string |
フィールドid | 種類string |
フィールドprovider | 種類string |
フィールドanswers.<id>.type | 種類string |
フィールドanswers.<id>.noul | 種類number |
フィールドanswers.<id>.choice | 種類string |
フィールドanswers.<id>.score | 種類number |
フィールドanswers.<id>.confidence | 種類number |
フィールドanswers.<id>.probabilities | 種類object |
フィールドanswers.<id>.legend | 種類object |
フィールドusage.input_tokens | 種類integer |
フィールドusage.output_tokens | 種類integer |
フィールドusage.cost | 種類number |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件必須フィールド、表現形式、または値が無効です | 次の手順指摘されたリクエストフィールドを修正してください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra cloudflare/clef-flash
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Cloudflare: Clef Flash
- 利用できる入力と結果は何ですか?
POST /v1/systemone·cloudflare/clef-flash:text,image→decisions- リクエストはどの項目を使用しますか?
POST /v1/systemone·cloudflare/clef-flash:model,provider,questions,session_id,state,trace,user