API 레퍼런스 · 확인

초안 확인

POSThttps://api.neta-ai.com/fact-check/v1/check

초안의 사실 주장(직함·대수·사건 날짜·기관 명칭 등)을 기준일의 사실과 맞춰 봅니다.

verdicts 에는 띄울 판정만, claims 에는 뽑은 주장이 모두 옵니다. summary 에 결과 요약이 옵니다.

꼼꼼히 확인하느라 1분 가까이 걸릴 수 있습니다. 나오는 대로 받으려면 스트림을 쓰세요.

공개 키는 6,000자까지입니다(넘으면 413, 세지 않음). 더 긴 초안은 스트림으로 보내세요. 계약 매체 키는 6,000자를 넘으면 202와 job_id 를 돌려줍니다.

요청 머리

이름타입설명
X-API-Key필수stringAPI 키. URL 쿼리·쿠키로는 받지 않습니다
Content-Type필수stringapplication/json

요청 본문

이름타입설명
text필수string초안 본문(평문, 최대 100,000자). 문단은 빈 줄로 나눕니다
titlestring | null제목(최대 500자)
subtitlestring | null부제(최대 1,000자)
as_ofstring(date-time) | null기준일 = 출고 예정 시각(ISO 8601, 시간대 포함). 비우면 요청 시각
exclude_selfboolean이미 출고된 기사로 시험할 때 true. 그 기사 자체를 근거에서 뺍니다. 기본 false

응답

200판정 결과

이름타입설명
request_idstring요청 id. 문의할 때 씁니다
engineobject판정 엔진 {version, build}. 응답 머리 X-Engine-Version 과 같습니다
as_ofstring판정에 쓴 기준일
sentences[]arrayid · text · start · end · section(title·subtitle·body) · paragraph
attachments[]array문장에서 떼어 낸 머리말·바이라인·사진 설명: kind · text
summaryobject요약: judged(확인한 주장) · alarms(wrong + check) · wrong · check · web_suggest · unchecked · top_unchecked[]
grade_countsobject등급별 개수
claims[]array뽑은 주장 모두: id · sentence_id · kind · text · start · end(문장 안 위치) · at_text
claims[].same_asstring같은 주장으로 묶인 위치면 처음 나온 주장의 id. 판정은 그 주장에만 붙습니다
claims[].web_checkbooleantrue 면 웹 확인 제안. 웹 확인 제안은 verdicts 가 아니라 여기와 summary 로 옵니다
verdicts[]array띄울 판정만: claim_id · verdict · correct · issue · note · evidence[] · confidence.level · web_check
verdicts[].gradestring결과 등급: wrong 틀림 · check 확인 필요 · advice 표기 권고 · ok 맞음 · web_suggest 웹 확인 제안 · unchecked 확인 못 함
verdicts[].grade_labelstring등급 이름(화면에 그대로 쓰세요)
verdicts[].grade_reasonstring짧은 이유
verdicts[].priorityinteger틀림·확인 필요의 보는 순서(1이 먼저)
verdicts[].evidence[]array기록(kind · status · sources[]) 또는 기사·웹 자료(kind article·web, title · url · quote)
verdict_countsobject판정 값별 개수(띄우지 않은 판정 포함)
unchecked[]array확인하지 못한 주장(최대 50): claim_id · sentence_id · text · label(이유)
incomplete[]array일부를 확인하지 못했을 때만: message
timings_ms.totalnumber처리 시간(ms)

202긴 초안의 비동기 작업(계약 매체 키만)

이름타입설명
job_idstring작업 id
statusstringqueued
응답 머리뜻
X-Daily-Limit하루 상한
X-Daily-Remaining오늘 남은 건수

오류

코드뜻
401키가 없거나 틀림(폐기한 키 포함)
422요청 형식 오류(필드·길이·매개변수 조합). detail 에 위치
413공개 키: 본문 6,000자 초과(세지 않음)
429하루 한도(1,000건) 또는 분당 한도(30) 초과. Retry-After(초)
503일시적으로 쓸 수 없음. Retry-After(초)