팩트체크 API · 시작하기
기사 초안의 사실 오류를 출고 전에 찾습니다
초안의 사실 주장을 출고 예정 시각의 사실과 맞춰 보고, 다르면 올바른 값과 근거를 돌려줍니다.
무엇을 하나요
- “현 대통령인 윤석열은 …” 같은 직함을 기준일의 재직자와 맞춰 봅니다.
- 대수·사건 날짜·국경일·국회 대수·기관과 정당 이름을 확인합니다.
- 판정마다
correct(올바른 값)와evidence(근거)가 붙습니다. - 필요하면 값 단위로 웹 자료와 맞춰 볼 수 있습니다(웹에서 더 확인).
무엇을 확인하고 무엇을 아직 못 하는지는 확인하는 것과 못 하는 것에 정리했습니다.
기본 주소는 https://api.neta-ai.com/fact-check/v1 입니다. 키마다 하루 1,000건(한국 시간 자정 초기화)·분당 30건까지 쓸 수 있습니다.
STEP 1
API 키 받기
키 받기에서 받습니다. 키 원문은 한 번만 보이니 바로 환경 변수에 넣으세요.
POST
https://api.neta-ai.com/fact-check/v1/keys예시는 모두 키를 환경 변수 FC_KEY에서 읽습니다.
export FC_KEY="fck_…"
키 발급
curl -X POST 'https://api.neta-ai.com/fact-check/v1/keys'
STEP 2
첫 요청 보내기
본문 text와 기준일 as_of(출고 예정 시각)를 보냅니다. 키는 X-API-Key 머리로 보냅니다.
POST
https://api.neta-ai.com/fact-check/v1/check6,000자가 넘는 초안
/check는 6,000자까지입니다. 더 긴 초안은 스트림(20,000자까지)으로 보내세요.POST /check
curl -X POST 'https://api.neta-ai.com/fact-check/v1/check' \
-H "X-API-Key: $FC_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "尹 대통령, 오늘 담화",
"text": "현 대통령인 윤석열은 13일 대국민 담화를 냈다. 제19대 대통령 윤석열은 2022년 5월 취임했다.",
"as_of": "2026-11-13T15:00:00+09:00"
}'STEP 3
결과 읽기
claims는 뽑은 주장 모두, verdicts는 띄울 판정만 담습니다. claim_id로 잇고, start·end(문장 안 위치)로 밑줄을 그으세요.
| verdict | 뜻 | 할 일 |
|---|---|---|
refuted 틀림 | 공식 기록과 다릅니다. correct에 올바른 값이 옵니다. | 고치기 |
recommend-check 확인 권장 | 다르게 보이지만 확정하지는 못했습니다. correct에 그래 보이는 값이 옵니다. | 확인 |
style 표기 권고 | 사실 오류가 아니라 표기 문제입니다(예: 전직자에 '전'이 빠짐). | 매체 표기 규칙대로 |
source-check 출처 확인 필요 | 인용한 보고서·조사·발표를 공개 자료에서 찾지 못했습니다. | 출처 확인 |
new-change 신규 변동 가능 | 공식 확정 전 기록만 있습니다(최근 인사·변동). | 최신 소식 확인 |
curl -X POST 'https://api.neta-ai.com/fact-check/v1/check' \
-H "X-API-Key: $FC_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "尹 대통령, 오늘 담화",
"text": "현 대통령인 윤석열은 13일 대국민 담화를 냈다. 제19대 대통령 윤석열은 2022년 5월 취임했다.",
"as_of": "2026-11-13T15:00:00+09:00"
}'응답(줄임)
{
"claims": [
{"id": "s2c1", "sentence_id": "s2", "kind": "holder_at",
"text": "현 대통령인 윤석열", "start": 0, "end": 10, "at_text": null}
],
"verdicts": [
{"claim_id": "s2c1", "verdict": "refuted",
"correct": "이재명 제21대 대통령", "issue": "현직자",
"evidence": [{"kind": "tenure", "person": "이재명", "ordinal": 21,
"start": "2025-06-04", "status": "confirmed",
"sources": [{"title": "대통령기록관", "tier": "tier-1",
"url": "https://www.pa.go.kr/"}]}],
"confidence": {"level": "보통"}},
…
],
"verdict_counts": {"refuted": 2},
"request_id": "9f2c1a7be04d3c55"
}