Cloudflare: Clef
Cloudflare Clef는 분류, 정책 점검, 에이전트 워크플로 선택을 위한 27B 멀티모달 의사결정 모델입니다. 제공된 상태와 유형이 지정된 질문을 평가하여 허용된 대안별 확률, 선택된 범주, 가중 점수를 반환합니다. 산문을 생성하지 않으며, 텍스트와 시각적 증거를 입력으로 받습니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Cloudflare Clef는 Clef 의사결정 제품군에서 더 큰 덴스 모델로, Qwen3.8-27B를 비전 인코더와 함께 사후 학습하여 만들어졌습니다. Cloudflare는 이 백본에 증거를 질문으로 라우팅하고 허용된 옵션을 함께 채점하는 결합 스키마 헤드를 연결합니다. Clef는 상황을 읽고 단일 순전파로 확률이 포함된 범위가 정해진 결정을 반환합니다. 출력은 생성된 산문, 열린 형식의 보고서 또는 제안된 명령이 아니라 분류 결과입니다.
상태와 질문 스키마를 별개의 입력으로 준비하세요. 상태는 기록, 대화, 문서 내용 또는 애플리케이션 상황을 나타내는 문자열이나 JSON일 수 있습니다. 질문은 안정적인 이름을 키로 사용하며, 같은 이름이 반환된 답변을 식별합니다. 각 질문이 무엇을 확정해야 하는지 정의하고 관련 옵션을 설명하세요. 지원 기록이라면 서로 다른 결정을 하나의 모호한 범주로 합치지 않고, 어느 팀이 요청을 처리해야 하는지, 영향이 긴급한지, 어떤 심각도 기준이 적용되는지를 각각 물을 수 있습니다.
noul 질문은 이진 조건에 대해 참일 확률을 반환합니다. 선택형 질문은 선택된 이름 있는 옵션, 옵션별 확률, 신뢰도를 반환합니다. 점수형 질문은 0부터 인덱스가 매겨지는 순서형 설명 목록을 사용하며, 기대 점수, 범례, 확률을 반환합니다. 소수 점수는 순서형 수준 전반의 불확실성을 요약하므로 의미가 있습니다. 선택된 답변뿐 아니라 분포도 함께 살펴보세요. 확률이 근소한 두 옵션은 입력만으로는 판가름 나지 않는 구분을 드러낼 수 있습니다.
정책 점검에는 실제 규칙 문안과 기록의 사실 관계를 포함하세요. 예를 들어 문서 처리 워크플로에서 기록이 완전한지, 어떤 검토 범주가 적용되는지, 증거가 즉각적인 주의를 얼마나 강하게 뒷받침하는지를 묻는 질문을 구성할 수 있습니다. 서로 다른 조건은 별도의 질문으로 물으세요. 준수 여부에 대한 모델의 평가는 제공된 규칙과 증거에 연결된 상태로 유지되어야 합니다. 중요한 조건이 누락된 경우를 위해 스키마와 애플리케이션에 그 불확실성을 처리하는 의도된 방식을 마련하세요.
시각적 증거에는 판독 가능한 이미지와, 보이는 조건이나 정의된 범주에 관한 질문을 제공하세요. 양식 품질 점검이라면 가독성, 필수 영역의 존재 여부, 제공된 품질 수준 중 무엇이 가장 잘 맞는지를 평가할 수 있습니다. 제작사의 오픈 웨이트 인터페이스는 비디오 프레임 배열도 받습니다. 프레임을 순서대로 유지하고 평가할 사건을 명시하세요. 범위가 정해진 결정 스키마는 해당 자료를 분류할 수 있으며, 서술형 묘사나 임의로 새로 생성된 필드를 요청하는 것은 다른 종류의 출력에 해당합니다.
제조사의 호스팅 레퍼런스에는 65,536토큰 컨텍스트, 1~64개의 질문, 최대 4개의 임베드 이미지가 명시되어 있습니다. PNG, JPEG 또는 WebP 이미지는 각각 4 MiB, 16메가픽셀로 제한되며 디코딩된 전체 크기는 8 MiB입니다. 요청 본문 전체는 13 MiB로 제한되며, 원격 이미지 링크는 받지 않습니다. 입력 예산에는 질문과 미디어가 포함됩니다. 긴 텍스트는 한도에 맞추기 위해 잘릴 수 있으므로 결정적인 구절과 출처 레이블을 보존하세요. 이 한도는 제작사의 호스팅 이미지 인터페이스에 관한 것이며, 오픈 웨이트 인코더는 자체적인 로컬 입력 표현 형식을 갖습니다.
Cloudflare의 릴리스는 스키마 기반 채점과 확률 보정을 위한 학습을 설명합니다. 모델은 개별 옵션에 관련된 증거를 추출한 다음, 여러 필드에 걸친 정보를 함께 고려합니다. 이는 한 기록 안의 여러 관련 질문에 대한 결정을 뒷받침할 수 있지만, 높은 확률이 근본 사실이 참임을 보장하지는 않습니다. 단순한 사례뿐 아니라 어렵거나 불완전하거나 범주를 벗어난 기록도 평가하세요. 유용한 결정 기준은 워크플로가 실제로 마주치는 상황을 포괄하고 중요한 구분을 명시적으로 드러냅니다.
에이전트 워크플로에서는 출력을 바탕으로 정의된 다음 단계 중 어느 것을 고려할지 결정할 수 있습니다. 현재 관찰 내용과 후보 조치를 명확한 설명과 함께 제공한 뒤, 선택된 옵션과 그 확률을 보관하세요. 이를 둘러싼 애플리케이션이 자체 조치 정책을 적용하고 수행한 내용을 기록합니다. 이 실행 기록은 결정 결과와 분리해 두세요. 검토 경로를 선택했다고 해서 검토자가 조치했다는 사실이 확인되는 것은 아니며, 진단 단계를 선택했다고 해서 그 단계가 성공했다는 사실이 확인되는 것도 아닙니다.
최종 결과물은 답변 객체와, 이를 생성한 상태 및 스키마를 함께 묶은 것입니다. 이 기록을 활용해 예상 밖의 분류를 검토하고, 모호한 기준을 찾아내고, 결과를 검토된 작업 예시와 비교하세요. 후속 사용자에게 서면 설명이 필요하다면 결정과 원본 증거를 별도의 응답 작성 단계에 입력으로 사용할 수 있습니다. 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 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 컨텍스트 토큰 수 초과 기준 | 컨텍스트 토큰 수 이하 기준 | 요금 |
|---|---|---|---|---|
| 설정토큰의 기본 단가 | 요금표기본 요금 | 컨텍스트 토큰 수 초과 기준— | 컨텍스트 토큰 수 이하 기준상한 없음 | 요금 입력 · 입력 토큰 $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