Cloudflare: Clef Omni
Cloudflare Clef Omni는 총 30B, 활성 3B 파라미터의 MoE 백본을 갖춘 멀티모달 의사결정 모델입니다. 제공된 텍스트, 구조화된 상태, 미디어를 유형이 지정된 질문에 비추어 평가하고, 확률과 범위가 정해진 결정을 반환합니다. 출력은 생성된 산문이 아니라 선택지, 참일 확률 또는 순서형 점수입니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Cloudflare Clef Omni는 Clef 의사결정 제품군의 멀티모달 전문가 혼합 모델입니다. Qwen3-Omni-30B-A3B-Instruct 이해 백본을 기반으로 사후 학습되었으며, 총 30B, 활성 3B 파라미터를 갖습니다. Cloudflare는 증거를 요청된 질문으로 라우팅하고 각 질문에 허용된 옵션을 함께 채점하는 결합 스키마 헤드를 추가합니다. 그 결과는 생성된 설명, 전사문 또는 음성 출력이 아니라 확률이 포함된 유형 지정 결정입니다.
두 가지 주요 부분을 준비하세요. 상황을 설명하는 상태와, 이름이 붙은 질문들의 매핑입니다. 상태는 텍스트나 구조화된 JSON일 수 있으며, 모델의 기본 입력에는 이미지, 오디오, 비디오도 포함됩니다. 각 질문은 무엇을 결정할지와 어떤 답이 허용되는지를 명시합니다. 애플리케이션이 반환된 각 답을 원래 질문과 연결할 수 있도록 식별자를 안정적으로 유지하세요. 옵션 설명이 명확해야 범주가 의미를 갖습니다. 짧고 모호한 레이블만 쓰면 워크플로에 실제로 필요한 구분이 가려질 수 있습니다.
레코드 형식에는 세 가지 질문 유형이 있습니다. noul 질문은 참/거짓 조건을 묻고 참일 확률을 반환합니다. 선택형 질문은 이름이 붙은 옵션을 정의하고, 선택된 옵션, 옵션별 확률, 별도의 신뢰도 값을 반환합니다. 점수형 질문은 0부터 인덱스가 매겨지는 순서형 기준을 정의하고, 확률 가중 점수, 범례, 확률을 반환합니다. 점수는 여러 수준에 걸친 분포를 반영하므로 소수가 될 수 있습니다. 따라서 결정은 단일 레이블보다 풍부한 정보를 담으면서도 제공된 스키마의 범위 안에 머뭅니다.
시각적 검토에는 선명한 이미지와 평가할 조건을 제공하세요. 예를 들어 설치 기록에 대해 식별 라벨이 보이는지, 정의된 상태 범주 중 어느 것에 해당하는지, 검토에 충분한 증거가 있는지를 묻는 질문을 구성할 수 있습니다. 관찰 항목은 서로 분리하세요. 라벨이 보이는지는 설치가 완료된 것으로 보이는지와 다른 질문입니다. 출력은 애플리케이션이 기록을 라우팅하거나 검토 조건을 표시하는 데 도움이 되지만, 출력 자체가 점검을 수행하거나 기록을 변경하거나 서면 보고서를 생성하지는 않습니다.
오디오와 비디오의 경우, 제공된 클립이 뒷받침할 수 있는 증거에 질문을 집중하세요. 실용적인 장비 검토라면 사진, 녹음, 짧은 비디오를 포함하고, 특정 소리가 들리는지 또는 부품이 눈에 띄게 움직이는지를 물을 수 있습니다. 제작사는 기록 내 모든 비디오에 소리가 있을 때 비디오의 사운드트랙을 프레임과 함께 처리한다고 설명합니다. 미디어와 서면 상태 사이의 관계를 유지하고, 첨부된 구간 밖에서 일어난 사건을 분류하도록 모델에 요청하지 마세요.
제조사의 호스팅 프로필에는 64,000토큰 컨텍스트와 1~64개의 질문이 명시되어 있습니다. 최대 4개의 이미지, 4개의 오디오 클립, 2개의 비디오를 받으며, 오디오 클립은 각각 300초, 비디오는 각각 60초로 제한됩니다. 이는 문서화된 제작사 인터페이스의 한도입니다. 미디어와 질문은 컨텍스트를 차지합니다. 미디어가 지나치게 많으면 요청이 실패할 수 있고, 긴 텍스트 상태는 한도에 맞추기 위해 잘릴 수 있습니다. 결정적인 증거는 핵심에 집중한 기록에 담고, 관련 없는 이력에 컨텍스트 창을 소비하기 전에 질문을 먼저 준비하세요.
제작사의 호스팅 인터페이스는 원격 링크가 아닌 임베드된 미디어를 받습니다. PNG, JPEG 또는 WebP 이미지는 각각 4 MiB, 16메가픽셀로 제한되며, 디코딩된 이미지 전체 예산은 8 MiB입니다. 각 오디오 클립은 8 MiB, 300초로, 각 비디오는 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 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 컨텍스트 토큰 수 초과 기준 | 컨텍스트 토큰 수 이하 기준 | 요금 |
|---|---|---|---|---|
| 설정토큰의 기본 단가 | 요금표기본 요금 | 컨텍스트 토큰 수 초과 기준— | 컨텍스트 토큰 수 이하 기준상한 없음 | 요금 입력 · 입력 토큰 $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