Clef API
Cloudflare의 오픈소스 Clef 의사결정 모델 패밀리: Clef(27B) 및 Clef Flash(9B)는 상태와 유형화된 질문을 확률적 의사결정으로 변환합니다.
Clef Flash API
cloudflare/clef-flash
Clef Flash는 Cloudflare의 오픈소스 Clef 의사결정 모델 패밀리의 빠른 9B 멤버로, Workers AI에서 제공되는 Qwen3.5-9B의 파인튜닝 모델입니다.
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를 선택합니다.