Clef API
Cloudflare의 오픈소스 Clef 의사결정 모델 패밀리: Clef(27B) 및 Clef Flash(9B)는 상태와 유형화된 질문을 확률적 의사결정으로 변환합니다.
Clef API
cloudflare/clef
Cloudflare Clef는 텍스트, JSON, 이미지 또는 비디오를 구조화된 확률 기반 JSON 답변으로 변환하는 27B 다중 모달 의사결정 모델입니다.
Clef API 배경
개요
Clef는 Cloudflare Workers AI에서 제공되는 Cloudflare의 오픈소스 의사결정 모델 패밀리입니다. 상태와 유형화된 질문 스키마를 의사결정으로 변환하며, 단 한 번의 순방향 전파(forward pass)만으로 모든 질문의 모든 허용된 옵션에 대한 확률을 반환합니다. 이 패밀리에는 Qwen3.8-27B를 미세조정한 27B 멀티모달 모델인 Clef와 Qwen3.5-9B를 미세조정한 빠르고 경량화된 9B 모델인 Clef Flash가 포함됩니다.
개발 과정
Cloudflare는 Clef 의사결정 모델을 오픈 웨이트 모델(Apache-2.0)로 공개했습니다. Clef는 Qwen3.8-27B의 비전 인코더와 공동 스키마 헤드(joint schema head)를 결합하여 사후 학습(post-training)되었으며, Clef Flash는 Qwen3.5-9B를 기반으로 사후 학습된 더 작고 빠른 변형 모델입니다. 두 모델 모두 Cloudflare Workers AI에서 서비스됩니다.
주요 혁신
- 단 한 번의 순방향 전파로 모든 질문의 모든 옵션에 대한 확률 반환
- 공동 스키마 헤드가 모든 질문의 모든 옵션을 함께 평가
- 텍스트, JSON 및 이미지를 입력으로 수용
- 자유 형식 텍스트 생성 및 출력 파싱 불필요
- Jev 및 SystemOne 의사결정 API와 완벽하게 호환
Clef API 기술 사양
구조
Clef는 비전 인코더가 포함된 Qwen3.8-27B 백본을 표준 샤딩된 safetensors 형식으로 저장하여 사용하며, 백본의 최종 숨겨진 상태(hidden states)를 읽어 상태의 근거를 각 질문으로 라우팅하고 모든 옵션을 함께 평가하는 공동 스키마 헤드를 사용합니다. Clef Flash는 더 작은 Qwen3.5-9B 백본을 사용합니다.
파라미터
Clef: 27B 매개변수. Clef Flash: 9B 매개변수.
기능
- 텍스트, JSON 및 이미지에 대한 멀티모달 의사결정
- 선택형(Choice), 점수형(Score), 참/거짓(noul) 질문 유형 지원
- 워크플로 라우팅 및 도구 선택
- 분류 및 가드레일 적용
- 구조화된 스키마 기반 의사결정
한계
- 자유 형식 텍스트 생성 불가(의사결정 결과만 출력)
- 커스텀 코드 또는 Cloudflare Workers AI를 통해 CPU/GPU로 제공됨
Clef API 성능
장점
- 분류, 도구 검색 및 추론 벤치마크 전반에서 높은 의사결정 정확도 제공
- 매우 낮은 지연 시간
- 모든 질문과 옵션에 대한 공동 평가 수행
- Clef Flash는 처리 속도에 최적화됨
실제 효과
Clef는 송장 처리, 고객 서비스 분류, 보안 침해 사고 분류, 에이전트 추적 관찰 가능성(observability) 등 빠르고 일관된 구조화된 의사결정이 중요한 엔드투엔드 비즈니스 워크플로를 목표로 합니다.
Clef API 언제 사용하나요
시나리오
- 텍스트나 이미지에 대해 빠르고 일관된 라우팅 또는 분류 의사결정이 필요한 경우. Clef API 패밀리는 자유 형식 텍스트 대신 모든 옵션에 대해 보정된 확률을 반환합니다.
- 도구나 가드레일을 안정적으로 선택해야 하는 에이전트 워크플로를 구축할 때. Clef API는 낮은 지연 시간의 의사결정을 위해 단 한 번의 순방향 전파로 각 허용된 옵션을 평가합니다.
- 송장과 같은 비즈니스 문서를 처리하고 구조화된 의사결정이 필요한 경우. Clef API는 상태와 유형화된 질문 스키마를 확률에 직접 매핑합니다.
모범 사례
- 명확한 유형(noul, choice, score)과 명시적 기준을 사용하여 각 질문을 정의합니다.
- 정확도를 극대화하기 위해 상태를 당면한 의사결정에 집중하여 구성합니다.
- 최대 정확도보다 지연 시간과 비용 절감이 더 중요한 경우 Clef Flash를 선택합니다.