Cloudflare: Clef
Cloudflare Clefは、分類、ポリシーの確認、エージェントのワークフロー上の選択に使う27Bのマルチモーダル判断モデルです。入力された状態と型付きの質問を評価し、許可された選択肢の確率、選択されたカテゴリ、加重スコアを返します。文章は生成せず、テキストと視覚的な証拠を受け付けます。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Cloudflare Clefは、視覚エンコーダーを備えたQwen3.8-27Bを追加学習した、Clef判断モデル群の大型デンスモデルです。Cloudflareは、このバックボーンに、証拠を質問へ振り分け、許可された選択肢をまとめて採点する共同スキーマヘッドを組み合わせています。Clefは状況を読み取り、1回の順伝播で、確率を伴う定義範囲内の判断を返します。出力は、生成された文章、自由形式の報告書、提案されたコマンドではなく、分類の結果です。
状態と質問スキーマを、別々の入力として準備してください。状態には、レコード、会話、文書内容、アプリケーションの状況を表す文字列またはJSONを使用できます。質問には一貫した名前をキーとして付け、返される回答も同じ名前で識別します。各質問で何を明らかにするべきかを定義し、関連する選択肢を説明してください。サポート記録なら、どのチームがリクエストを担当するべきか、影響は緊急性を持つか、どの重大度基準に該当するかを、それぞれ異なる判断を1つの曖昧なカテゴリにまとめずに質問できます。
noul質問は、二値条件が真である確率を返します。choice質問は、選択された名前付きの選択肢、選択肢ごとの確率、信頼度を返します。score質問は、ゼロから始まるインデックスを持つ説明の順序付きリストを使い、期待スコア、凡例、確率を返します。小数のスコアには、順序付きのレベル間に分布する不確実性を要約する意味があります。選択された回答だけでなく分布も点検してください。確率が近い2つの選択肢は、入力だけでは決められない違いを示すことがあります。
ポリシーの確認では、実際のルール本文とレコードの事実を含めてください。たとえば文書処理のワークフローで、レコードが完全か、どの確認カテゴリに該当するか、証拠が即時対応の必要性をどの程度強く裏付けるかを質問できます。別の条件には別の質問を使ってください。モデルによる適合性の評価は、入力されたルールと証拠に結び付けたまま扱う必要があります。重要な条件が欠けている場合は、その不確実性をどう処理するかをスキーマとアプリケーションで意図的に設計してください。
視覚的な証拠には、判読できる画像と、目に見える条件または定義済みのカテゴリに関する質問を入力します。フォームの品質確認なら、判読性、必須領域が存在するか、入力された品質レベルのうちどれが最もよく当てはまるかを評価できます。メーカーのオープンウェイト用インターフェースは、動画フレームの配列も受け付けます。フレームの順序を保ち、評価する事象を特定してください。定義範囲内の判断スキーマでその資料を分類することはできますが、物語形式の説明や、任意の新しいフィールドの生成を求めるリクエストは、別種の出力に属します。
メーカーのホステッド参照仕様には、65,536トークンのコンテキスト、1〜64件の質問、最大4枚の埋め込み画像が記載されています。PNG、JPEG、WebP画像は1枚あたり4 MiB、16メガピクセルが上限で、デコード後の合計は8 MiBです。リクエスト本文全体の上限は13 MiBで、リモート画像リンクは受け付けません。入力上限には、質問とメディアも含まれます。長いテキストは収まるように切り詰められる場合があるため、判断に必要な箇所と出典ラベルを残してください。これらの制限はメーカーのホステッド画像インターフェースを説明するもので、オープンウェイトのエンコーダーには独自のローカル入力表現があります。
Cloudflareのリリース説明には、スキーマに制約された採点と確率の較正のための学習が記されています。モデルは個々の選択肢に関連する証拠を抽出し、その後、フィールドをまたいで情報を考慮します。これにより、1つのレコード内の複数の関連する質問に対する判断を支援できますが、確率が高いからといって、基になる事実が真であると保証されるわけではありません。単純なケースだけでなく、難しいレコード、不完全なレコード、カテゴリ外のレコードも評価してください。有用な判断基準は、ワークフローが実際に遭遇する状況を網羅し、重要な違いを明示します。
エージェントのワークフローでは、定義済みの次の工程のうち、どれを検討するべきかを出力によって決められます。現在の観測と、明確な説明を付けた候補行動を入力し、選択された選択肢とその確率を保持してください。周囲のアプリケーションが行動ポリシーを適用し、実行した内容を記録します。その実行記録は判断結果と分けてください。確認経路を選んでも、確認担当者が実際に対応したと証明されるわけではなく、診断工程を選んでも、その工程が成功したと証明されるわけではありません。
最終的な成果物は、answersオブジェクトと、それを生成した状態およびスキーマです。これらの記録を使って、予想外の分類を点検し、曖昧な基準を特定し、確認済みのタスク例と結果を比較してください。後続のユーザーが文章による説明を必要とする場合は、判断と元の証拠を別の回答作成工程の入力にできます。Clefは、何を評価したかを明確に記録した上で次の段階を選ぶために必要な、定義範囲内の確率的判断を提供します。
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefはじめに
Cloudflare Clefは、分類、ポリシーの確認、エージェントのワークフロー上の選択に使う27Bのマルチモーダル判断モデルです。入力された状態と型付きの質問を評価し、許可された選択肢の確率、選択されたカテゴリ、加重スコアを返します。文章は生成せず、テキストと視覚的な証拠を受け付けます。
- 対応する入力
- テキスト · 画像
- 結果
- decisions
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · System One POST /v1/systemone
- 入力の種類
text,image- 出力の種類
decisions- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 cloudflare/clef | デフォルト— |
フィールド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.00048 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定リクエスト長に応じた料金区分 1 | 料金表— | コンテキストトークン数が次の値を超える場合0 | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $0.00048 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · System One
{
"model": "cloudflare/clef",
"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'
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
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Cloudflare: Clef
- 利用できる入力と結果は何ですか？
POST /v1/systemone·cloudflare/clef:text,image→decisions- リクエストはどの項目を使用しますか？
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user