Cloudflare: Clef Flash
Cloudflare Clef Flash는 빠른 분류와 워크플로 선택을 위해 설계된 9B 규모의 소형 Clef 의사결정 모델입니다. 텍스트, 구조화된 상태, 시각 입력을 이름이 붙은 질문에 비추어 평가하고, 산문을 생성하지 않고 옵션별 확률, 선택된 범주 또는 순서형 점수를 반환합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Cloudflare Clef Flash는 Clef 제품군의 소형 의사결정 모델로, Qwen3.5-9B를 비전 인코더와 함께 사후 학습하여 만들어졌습니다. 결합 스키마 헤드가 입력에서 증거를 읽고, 요청된 모든 질문의 허용 답변을 단일 순전파로 채점합니다. 이 모델의 역할은 워크플로 안에서 범위가 정해진 분류와 결정을 생성하는 것입니다. 출력은 애플리케이션이 범주로 해석해야 하는 대화형 답변이 아니라 확률이 포함된 유형 지정 결과입니다.
상황은 텍스트 또는 JSON 상태로 기술하고, 질문은 별도로 정의하세요. 질문에는 안정적인 이름, 유형, 명확한 지시가 필요하며, 범주형 또는 점수형 질문은 허용 기준도 정의합니다. 지원 메시지의 경우 한 질문은 문제를 분류하고, 다른 질문은 긴급도를 평가하며, 또 다른 질문은 다음 단계에 필요한 정보가 기록에 빠져 있는지를 판별할 수 있습니다. 결정이 증거에 근거하도록 실제 고객 문구, 관련 이력, 운영 규칙을 상태에 담으세요.
세 가지 질문 유형은 서로 다른 요구에 대응합니다. noul 결과는 참/거짓 조건이 성립할 확률입니다. 선택형 결과는 이름이 붙은 옵션 하나를 지정하고, 대안 전체에 걸친 확률과 신뢰도 값을 포함합니다. 점수형 결과는 순서형 기준을 평가하여 확률 가중 점수, 범례, 분포를 반환합니다. 점수의 순서는 의도적으로 정의하세요. “조치 불필요”에서 “즉시 검토”로 이어지는 단계는 순서 없는 주제 레이블 집합과 다릅니다.
빠른 라우팅을 위해서는 실제로 범주를 구분하는 조치나 책임 경계를 기준으로 범주를 설명하세요. 유용한 예로 계정 접근, 기술적 결함, 문서 관련 질문, 기타 중에서 선택하는 요청이 있으며, 각 옵션에는 설명이 붙습니다. 모델의 결과는 애플리케이션의 라우팅 규칙으로 전달할 수 있습니다. 기술적 결함과 계정 접근 사이의 확률 분포가 근소하다면 이는 모호성을 보여 주는 유용한 증거입니다. 선택된 레이블을 확정된 진단으로 간주하지 말고, 워크플로가 그런 사례를 어떻게 처리할지 명시적으로 정하세요.
시각적 분류에는 판독 가능한 이미지와, 그 이미지가 뒷받침할 수 있는 조건을 제공하세요. 영수증 검토라면 합계 금액이 읽히는지 묻고, 정의된 문서 품질 범주 중에서 선택하게 할 수 있습니다. 모델을 제한 없는 추출 또는 작성 서비스처럼 취급하여 임의의 새 합계를 요청해서는 안 됩니다. 제작사의 오픈 웨이트 인터페이스는 비디오 프레임 배열도 받습니다. 프레임과 서면 상태 사이의 연결을 유지하고, 해당 자료 안에서 보이는 사건이나 조건에 대해 질문하세요.
현재 제조사의 호스팅 레퍼런스에는 24,576토큰 컨텍스트, 최대 64개의 질문, 최대 4개의 임베드 이미지가 명시되어 있습니다. PNG, JPEG 또는 WebP 이미지는 각각 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는 빠른 분류와 워크플로 선택을 위해 설계된 9B 규모의 소형 Clef 의사결정 모델입니다. 텍스트, 구조화된 상태, 시각 입력을 이름이 붙은 질문에 비추어 평가하고, 산문을 생성하지 않고 옵션별 확률, 선택된 범주 또는 순서형 점수를 반환합니다.
- 허용 입력
- 텍스트 · 이미지
- 결과
- 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 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 컨텍스트 토큰 수 초과 기준 | 컨텍스트 토큰 수 이하 기준 | 요금 |
|---|---|---|---|---|
| 설정토큰의 기본 단가 | 요금표기본 요금 | 컨텍스트 토큰 수 초과 기준— | 컨텍스트 토큰 수 이하 기준상한 없음 | 요금 입력 · 입력 토큰 $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