연동 키트API 연동Clairic
Cloudflare Workers AI Clairic 추출 연동
- 누가 · 어디에
- 백엔드 개발자가 비정형 문서·고객 문의·영수증에서 정형 데이터를 자동 추출하는 업무에
- 업무 효과
- 텍스트 생성 없이 스키마 기반 값과 신뢰도를 즉시 추출해 처리 속도를 높이고 파이프라인 비용 절감
공식 API · SDK 로 우리 시스템에 붙입니다. AI 가 공식 문서를 찾아 정리한 가이드로, mopick 이 직접 따라 해 보지는 않았습니다 · 공식 문서에서 제품을 확인했습니다
준비할 것
- Cloudflare 계정 및 Account ID
- Workers AI Read/Edit 권한이 부여된 Cloudflare API 토큰
- cURL 또는 REST API 호출이 가능한 개발 환경
연동 단계
해 본 단계는 번호를 눌러 표시하세요. 표시는 이 브라우저에만 남습니다.
0% 진행
API 토큰 발급
Cloudflare 대시보드의 'My Profile > API Tokens' 메뉴에서 'Create Token'을 누르고 Workers AI 권한을 포함한 사용자 정의 토큰을 생성합니다.
계정 ID 확인
Cloudflare 대시보드 우측 사이드바 또는 URL 경로에서 본인 계정의 고유 'Account ID'를 확인하고 복사합니다.
추출 스키마 정의
분석할 비정형 텍스트(state)와 추출할 항목의 데이터 타입(text, number, date 등) 및 지시문(instructions)을 JSON 구조로 정의합니다.
API 호출 실행
Workers AI 엔드포인트(@cf/cloudflare/clairic)로 계정 ID와 토큰을 헤더에 담아 POST 요청을 보냅니다.
붙여 넣는 설정 · 코드
YOUR_API_KEY 같은 자리에는 내 값을 넣으세요. 키는 코드 · 문서에 그대로 남기지 말고 환경 변수 · 비밀 저장소에 두세요.
Clairic REST API 호출 bash
curl -X POST "https://api.cloudflare.com/client/v4/accounts/YOUR_ACCOUNT_ID/ai/run/@cf/cloudflare/clairic" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "clairic",
"state": "주문번호 ORD-20261118, 2026-11-18 배송 완료. 결제 금액 45000원.",
"fields": {
"order_id": {"type": "text", "instructions": "주문번호"},
"delivered_date": {"type": "date", "instructions": "배송 완료일"},
"total_amount": {"type": "number", "unit": "KRW", "instructions": "결제 금액"}
}
}'- 잘 연결됐는지 확인
- 응답 JSON의 answers 객체 내에 지정한 각 필드 값과 confidence 점수가 정상 반환되는지 확인합니다.
- 비용
- 입력 토큰 100만 개당 $0.10(출력 토큰 과금 없음). 일일 무료 한도 10,000 Neurons 제공.
- 주의
- · 반환된 값의 타입과 제약조건은 유지되나 내용의 사실 여부는 보장되지 않으므로 중요 결제·승인 업무 전 검증 절차가 필수입니다.
- · 추출 결과의 신뢰도(confidence)와 결측 확률(p_null)을 확인하여 기준 점수 미달 시 수동 검토로 분기 처리해야 합니다.
공식 문서
우리 회사 시스템에 붙여야 한다면 — 업무 앱 · 사내 자료 · 보안 조건에 맞춘 연동을 TPI INSIGHT AX센터가 함께합니다.