Cloudflare: Clef
Cloudflare Clef ialah model keputusan multimodal 27B untuk klasifikasi, semakan dasar dan pilihan dalam aliran kerja ejen. Ia menilai keadaan yang dibekalkan dan soalan berjenis, lalu mengembalikan kebarangkalian bagi alternatif yang dibenarkan, kategori terpilih dan skor berwajaran. Ia menerima bukti teks dan visual tanpa menjana prosa.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Cloudflare Clef ialah model padat yang lebih besar dalam keluarga keputusan Clef, dilatih lanjut daripada Qwen3.8-27B bersama pengekod visinya. Cloudflare menggabungkan tulang belakang itu dengan kepala skema bersama yang menghalakan bukti kepada soalan dan memberi skor kepada opsyen yang dibenarkan secara serentak. Clef membaca sesuatu situasi dan mengembalikan keputusan terbatas dengan kebarangkalian dalam satu laluan hadapan. Outputnya ialah hasil klasifikasi, bukannya prosa yang dijana, laporan terbuka atau arahan yang dicadangkan.
Sediakan keadaan dan skema soalan sebagai input yang berasingan. Keadaan boleh berupa rentetan atau JSON yang mewakili rekod, perbualan, kandungan dokumen atau situasi aplikasi. Soalan dikunci dengan nama yang stabil, dan nama yang sama mengenal pasti jawapan yang dikembalikan. Takrifkan perkara yang perlu ditentukan oleh setiap soalan dan terangkan opsyen yang berkaitan. Rekod sokongan boleh bertanya pasukan manakah yang patut mengendalikan permintaan, sama ada impaknya mendesak dan kriteria keterukan manakah yang terpakai, tanpa menggabungkan keputusan-keputusan yang berbeza itu ke dalam satu kategori yang samar.
Soalan noul mengembalikan kebarangkalian benar bagi syarat binari. Soalan pilihan mengembalikan opsyen bernama yang dipilih, kebarangkalian bagi setiap opsyen dan keyakinan. Soalan skor menggunakan senarai penerangan bertertib yang diindeks bermula daripada sifar, dan mengembalikan skor jangkaan, legenda dan kebarangkalian. Skor pecahan bermakna kerana ia meringkaskan ketidakpastian merentas tahap bertertib. Periksa taburan serta jawapan yang dipilih; dua opsyen yang hampir sama boleh mendedahkan perbezaan yang tidak dapat diputuskan oleh input.
Untuk semakan dasar, sertakan teks peraturan sebenar dan fakta rekod. Contohnya ialah aliran kerja pemprosesan dokumen dengan soalan sama ada rekod lengkap, kategori semakan manakah yang terpakai dan sejauh mana bukti menyokong perhatian segera. Ajukan soalan berasingan untuk kondisi yang berasingan. Penilaian model tentang pematuhan harus kekal berkait dengan peraturan dan bukti yang dibekalkan. Jika kondisi penting tiada, skema dan aplikasi harus mempunyai cara yang dirancang dengan teliti untuk mengendalikan ketidakpastian itu.
Untuk bukti visual, berikan imej yang boleh dibaca dan soalan tentang kondisi yang kelihatan atau kategori yang ditetapkan. Semakan kualiti borang mungkin menilai kebolehbacaan, sama ada ruangan wajib wujud dan tahap kualiti yang dibekalkan manakah yang paling tepat menggambarkannya. Antara muka pemberat terbuka pembuat model juga menerima tatasusunan bingkai video. Pastikan bingkai mengikut urutan dan kenal pasti peristiwa yang hendak dinilai. Skema keputusan terbatas boleh mengklasifikasikan bahan tersebut, manakala permintaan untuk penerangan naratif atau medan baharu yang dijana sewenang-wenangnya tergolong dalam jenis output yang berbeza.
Rujukan dihoskan pengeluar menyenaraikan konteks 65,536 token, satu hingga 64 soalan dan sehingga empat imej terbenam. Imej PNG, JPEG atau WebP dihadkan kepada 4 MiB dan 16 megapiksel setiap satu, dengan jumlah 8 MiB selepas nyahkod; keseluruhan badan permintaan dihadkan kepada 13 MiB, dan pautan imej jauh tidak diterima. Bajet input merangkumi soalan dan media. Teks yang panjang mungkin dipotong supaya muat, jadi kekalkan petikan penentu dan label sumber. Had ini menerangkan antara muka imej dihoskan pengeluar; pengekod pemberat terbuka mempunyai perwakilan input setempatnya sendiri.
Pengumuman keluaran Cloudflare menerangkan latihan untuk pemarkahan terikat skema dan kalibrasi kebarangkalian. Model mengekstrak bukti yang berkaitan bagi opsyen individu dan kemudian mempertimbangkan maklumat merentas medan. Ini boleh menyokong keputusan bagi beberapa soalan berkaitan dalam satu rekod, tetapi ia tidak menjadikan kebarangkalian tinggi sebagai jaminan bahawa fakta asasnya benar. Nilaikan rekod yang sukar, tidak lengkap dan di luar kategori, selain kes yang mudah. Kriteria keputusan yang berguna meliputi situasi yang benar-benar dihadapi oleh aliran kerja dan menjadikan perbezaan penting jelas.
Dalam aliran kerja ejen, output boleh menentukan langkah seterusnya yang ditetapkan manakah yang patut dipertimbangkan. Bekalkan pemerhatian semasa dan tindakan calon dengan penerangan yang jelas, kemudian simpan opsyen yang dipilih beserta kebarangkaliannya. Aplikasi di sekelilingnya menerapkan dasar tindakannya dan merekodkan apa yang dilakukannya. Asingkan rekod pelaksanaan itu daripada hasil keputusan: memilih laluan semakan tidak membuktikan bahawa penyemak telah bertindak, dan memilih langkah diagnostik tidak membuktikan bahawa langkah itu berjaya.
Artifak akhir ialah objek jawapan bersama keadaan dan skema yang menghasilkannya. Gunakan rekod tersebut untuk memeriksa klasifikasi yang tidak dijangka, mengenal pasti kriteria yang samar-samar dan membandingkan hasil dengan contoh tugasan yang telah disemak. Jika pengguna hiliran memerlukan penjelasan bertulis, keputusan dan bukti asal boleh menjadi input kepada langkah penulisan respons yang berasingan. Clef membekalkan keputusan kebarangkalian terbatas yang diperlukan untuk memilih peringkat seterusnya itu, dengan gambaran jelas tentang perkara yang telah dinilai.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefPengenalan
Cloudflare Clef ialah model keputusan multimodal 27B untuk klasifikasi, semakan dasar dan pilihan dalam aliran kerja ejen. Ia menilai keadaan yang dibekalkan dan soalan berjenis, lalu mengembalikan kebarangkalian bagi alternatif yang dibenarkan, kategori terpilih dan skor berwajaran. Ia menerima bukti teks dan visual tanpa menjana prosa.
- Input yang diterima
- Teks · Imej
- Hasil
- decisions
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · System One POST /v1/systemone
- Input
text,image- Output
decisions- Format output
- json
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had cloudflare/clef | Lalai— |
Medanprovider | Jenisschema | KeperluanPilihan | Nilai & had | Lalai— |
Medanquestions | Jenisobject | KeperluanDiperlukan | Nilai & had | Lalai— |
Medansession_id | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medanstate | Jenisschema | KeperluanDiperlukan | Nilai & had | Lalai— |
Medantrace | Jenisschema | KeperluanPilihan | Nilai & had | Lalai— |
Medanuser | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medanquestions.<id>.type | Jenisstring | KeperluanDiperlukan | Nilai & had noul, choice, score | Lalai— |
Medanquestions.<id>.instructions | Jenisstring|object|array | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanquestions.<id>.criteria | Jenisobject|array | KeperluanPilihan | Nilai & had Syarat: choice/score: wajib; noul: pilihan. Kriteria choice ialah objek; score ialah tatasusunan dengan minItems1. | Lalai— |
Medanquestions.<id>.criteria.true | Jenisstring|object|array | KeperluanDiperlukan | Nilai & had Terpakai apabila: Objek kriteria noul dibekalkan | Lalai— |
Medanquestions.<id>.criteria.false | Jenisstring|object|array | KeperluanDiperlukan | Nilai & had Terpakai apabila: Objek kriteria noul dibekalkan | Lalai— |
Gabungan bahan input
noul · Diperlukan: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Diperlukan: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Diperlukan: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, state, questions |
Parametermaterial_types | Kontraktext, image |
Parameteroptional_controls | Kontrakprovider, session_id, trace, user |
Parametermultimodal_input_binding | KontrakGunakan hanya bentuk perwakilan keadaan/dokumen tepat yang diisytiharkan. Keupayaan imej pengeluar sahaja tidak membuktikan bentuk input imej yang diterima bagi model tertentu. |
Kitar hayat: synchronous
Hantar ID model yang tepat dan simpan respons natif yang lengkap.
Pelan harga
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Kadar Ailoot
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Token konteks, melebihi | Token konteks, sehingga dan termasuk | Caj |
|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Token konteks, melebihi— | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.00048 / 1K token Output · Token output $0 / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiTahap panjang permintaan 1 | Jadual kadar— | Token konteks, melebihi0 | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.00048 / 1K token Output · Token output $0 / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
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
Terima dan simpan hasil
Ailoot Ultra · System One
json
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Setiap jawapan bagi ID soalan yang diberikan dikekalkan berserta jenis tepatnya, nilai noul/choice/score, keyakinan, kebarangkalian dan petunjuk. Keseluruhan JSON asal disimpan dan hanya dikembalikan selepas penyelesaian caj.
Jika respons asal perlu disemak
Simpan operasi asal dan balasan penuh/separa; jangan ulang POST.
Medan respons
| Medan | Jenis |
|---|---|
Medanmodel | Jenisstring |
Medanid | Jenisstring |
Medanprovider | Jenisstring |
Medananswers.<id>.type | Jenisstring |
Medananswers.<id>.noul | Jenisnumber |
Medananswers.<id>.choice | Jenisstring |
Medananswers.<id>.score | Jenisnumber |
Medananswers.<id>.confidence | Jenisnumber |
Medananswers.<id>.probabilities | Jenisobject |
Medananswers.<id>.legend | Jenisobject |
Medanusage.input_tokens | Jenisinteger |
Medanusage.output_tokens | Jenisinteger |
Medanusage.cost | Jenisnumber |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, bentuk perwakilan atau nilai tidak sah | Langkah seterusnyaBetulkan medan permintaan yang dinyatakan. |
Alias
Alias model
Ailoot Ultra cloudflare/clef
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Cloudflare: Clef
- Apakah input dan hasil yang tersedia?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Apakah medan yang digunakan oleh permintaan?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user