Cloudflare: Clef Omni
Cloudflare Clef Omniは、総パラメータ数30B、アクティブパラメータ数3BのMoEバックボーンを持つマルチモーダル判断モデルです。入力されたテキスト、構造化された状態、メディアを型付きの質問に照らして評価し、確率と、定義された範囲内の判断を返します。出力は生成された文章ではなく、選択肢、真である確率、または順序付きのスコアです。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Cloudflare Clef Omniは、Clef判断モデル群に属するマルチモーダルの混合エキスパートモデルです。理解処理を担うQwen3-Omni-30B-A3B-Instructバックボーンを追加学習したモデルで、総パラメータ数は30B、アクティブパラメータ数は3Bです。Cloudflareは、証拠を要求された質問へ振り分け、許可された選択肢をまとめて採点する共同スキーマヘッドを追加しています。結果は、生成された説明、文字起こし、音声出力ではなく、確率を伴う型付きの判断です。
主に2つの要素を準備します。状況を記述する状態と、名前付きの質問を対応付けたマッピングです。状態にはテキストまたは構造化JSONを使用でき、モデルのネイティブ入力には画像、音声、動画も含まれます。それぞれの質問で、何を判断するか、どの回答を許可するかを指定します。アプリケーションが返された各回答を元の質問に対応付けられるよう、識別子は一貫して維持してください。選択肢の説明が明確であれば、カテゴリの意味も明確になります。短く曖昧なラベルでは、ワークフローに本当に必要な区別が隠れてしまうことがあります。
レコード形式には3種類の質問があります。noul質問は真偽条件を問い、真である確率を返します。choice質問は名前付きの選択肢を定義し、選択された選択肢、選択肢ごとの確率、それらとは別の信頼度を返します。score質問はゼロから始まるインデックスを持つ順序付きの基準を定義し、確率加重スコア、凡例、確率を返します。スコアは各レベルに対する分布を反映するため、小数になることもあります。このため、判断には単一のラベル以上の情報が含まれますが、入力されたスキーマの範囲には収まります。
目視確認では、鮮明な画像と評価したい条件を入力します。たとえば設置記録に対し、識別ラベルが見えるか、定義済みの状態カテゴリのうちどれに該当するか、確認に十分な証拠があるかを質問できます。観察事項は分けてください。ラベルが見えるかという質問と、設置が完了しているように見えるかという質問は別です。出力は、アプリケーションが記録を振り分けたり、確認が必要な条件にフラグを立てたりする際に役立ちます。ただし、モデル自体が検査を実施したり、記録を変更したり、文章の報告書を生成したりするわけではありません。
音声や動画では、入力クリップが裏付けられる証拠に質問を絞ります。実際の機器確認で、写真、録音、短い動画を使い、指定した音があるか、ある部品が目に見える形で動いているかを質問する例が考えられます。メーカーは、レコード内のすべての動画に音声がある場合、動画のフレームとともに音声トラックも処理すると説明しています。メディアと文章で記述した状態の関係を維持し、添付した時間区間の外で起きた事象を分類させないようにしてください。
メーカーのホステッド環境のプロファイルには、64,000トークンのコンテキストと、1〜64件の質問が記載されています。画像は最大4枚、音声クリップは最大4件、動画は最大2件を受け付け、音声クリップは1件あたり300秒、動画は1件あたり60秒が上限です。これらは、文書化されたメーカー側インターフェースの制限です。メディアと質問はコンテキストを消費します。メディアが多すぎるとリクエストが失敗することがあり、長いテキスト状態は収まるように切り詰められる場合があります。判断に必要な証拠を焦点の定まったレコードにまとめ、無関係な履歴にウィンドウを使う前に質問を準備してください。
メーカーのホステッドインターフェースは、リモートリンクではなく埋め込みメディアを受け取ります。PNG、JPEG、WebP画像は1枚あたり4 MiB、16メガピクセルが上限で、デコード後の画像全体の上限は8 MiBです。音声クリップは1件あたり8 MiB、300秒、動画は1件あたり16 MiB、60秒が上限です。音声と動画を合わせたデコード後の合計は最大16 MiBで、動画は毎秒2フレームでサンプリングされます。これらの制限はメーカー側のそのインターフェースに適用され、オープンウェイトのエンコーダーは追加のローカル表現も受け付けます。理解用バックボーンに音声機能があるからといって、この判断モデルが音声を生成するわけではありません。判断の採点には音声生成コンポーネントを使用しません。
サポートやワークフローの振り分けでは、実際の運用ルールに基づいてカテゴリと順序付きの基準を定義します。チケットのレコードなら、どのチームが担当するべきか、影響は緊急性を持つか、証拠に最も合う重大度レベルはどれかを質問できます。観測できる出力は、それらの質問名に対応する型付き回答の集合です。カテゴリ間の差が小さい場合は確率分布全体を確認し、不確実なケースをアプリケーションがどう扱うかを明示的に定義してください。高い確率は、入力された証拠に対するモデルの評価であり、その条件が独立に検証された証明ではありません。
結果を点検する際は、状態、質問スキーマ、返された回答をまとめて保持してください。選択肢が実際の状況を網羅しているか、説明が重複していないか、重要な証拠が省略されたり切り詰められたりしていないかを確認します。後続の処理で文章による説明が必要なら、判断と元の資料を別の文章作成工程への入力にできます。Clef Omniが役立つのは、マルチモーダルの証拠から定義済みの選択肢を採点し、明確で点検可能な入力と出力に基づいて次の行動を選べるようにする場面です。
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-omni
cloudflare/clef-omniはじめに
Cloudflare Clef Omniは、総パラメータ数30B、アクティブパラメータ数3BのMoEバックボーンを持つマルチモーダル判断モデルです。入力されたテキスト、構造化された状態、メディアを型付きの質問に照らして評価し、確率と、定義された範囲内の判断を返します。出力は生成された文章ではなく、選択肢、真である確率、または順序付きのスコアです。
- 対応する入力
- テキスト · 画像
- 結果
- decisions
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · System One POST /v1/systemone
- 入力の種類
text,image- 出力の種類
decisions- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 cloudflare/clef-omni | デフォルト— |
フィールド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.0003 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定リクエスト長に応じた料金区分 1 | 料金表— | コンテキストトークン数が次の値を超える場合0 | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $0.0003 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · System One
{
"model": "cloudflare/clef-omni",
"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-omni'
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-omni
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Cloudflare: Clef Omni
- 利用できる入力と結果は何ですか?
POST /v1/systemone·cloudflare/clef-omni:text,image→decisions- リクエストはどの項目を使用しますか?
POST /v1/systemone·cloudflare/clef-omni:model,provider,questions,session_id,state,trace,user