API 레퍼런스 · 확인
초안 확인
POST
https://api.neta-ai.com/fact-check/v1/check초안의 사실 주장(직함·대수·사건 날짜·기관 명칭 등)을 기준일의 사실과 맞춰 봅니다.
verdicts 에는 띄울 판정만, claims 에는 뽑은 주장이 모두 옵니다. summary 에 결과 요약이 옵니다.
꼼꼼히 확인하느라 1분 가까이 걸릴 수 있습니다. 나오는 대로 받으려면 스트림을 쓰세요.
공개 키는 6,000자까지입니다(넘으면 413, 세지 않음). 더 긴 초안은 스트림으로 보내세요. 계약 매체 키는 6,000자를 넘으면 202와 job_id 를 돌려줍니다.
요청 머리
| 이름 | 타입 | 설명 |
|---|---|---|
X-API-Key필수 | string | API 키. URL 쿼리·쿠키로는 받지 않습니다 |
Content-Type필수 | string | application/json |
요청 본문
| 이름 | 타입 | 설명 |
|---|---|---|
text필수 | string | 초안 본문(평문, 최대 100,000자). 문단은 빈 줄로 나눕니다 |
title | string | null | 제목(최대 500자) |
subtitle | string | null | 부제(최대 1,000자) |
as_of | string(date-time) | null | 기준일 = 출고 예정 시각(ISO 8601, 시간대 포함). 비우면 요청 시각 |
exclude_self | boolean | 이미 출고된 기사로 시험할 때 true. 그 기사 자체를 근거에서 뺍니다. 기본 false |
응답
200판정 결과
| 이름 | 타입 | 설명 |
|---|---|---|
request_id | string | 요청 id. 문의할 때 씁니다 |
engine | object | 판정 엔진 {version, build}. 응답 머리 X-Engine-Version 과 같습니다 |
as_of | string | 판정에 쓴 기준일 |
sentences[] | array | id · text · start · end · section(title·subtitle·body) · paragraph |
attachments[] | array | 문장에서 떼어 낸 머리말·바이라인·사진 설명: kind · text |
summary | object | 요약: judged(확인한 주장) · alarms(wrong + check) · wrong · check · web_suggest · unchecked · top_unchecked[] |
grade_counts | object | 등급별 개수 |
claims[] | array | 뽑은 주장 모두: id · sentence_id · kind · text · start · end(문장 안 위치) · at_text |
claims[].same_as | string | 같은 주장으로 묶인 위치면 처음 나온 주장의 id. 판정은 그 주장에만 붙습니다 |
claims[].web_check | boolean | true 면 웹 확인 제안. 웹 확인 제안은 verdicts 가 아니라 여기와 summary 로 옵니다 |
verdicts[] | array | 띄울 판정만: claim_id · verdict · correct · issue · note · evidence[] · confidence.level · web_check |
verdicts[].grade | string | 결과 등급: wrong 틀림 · check 확인 필요 · advice 표기 권고 · ok 맞음 · web_suggest 웹 확인 제안 · unchecked 확인 못 함 |
verdicts[].grade_label | string | 등급 이름(화면에 그대로 쓰세요) |
verdicts[].grade_reason | string | 짧은 이유 |
verdicts[].priority | integer | 틀림·확인 필요의 보는 순서(1이 먼저) |
verdicts[].evidence[] | array | 기록(kind · status · sources[]) 또는 기사·웹 자료(kind article·web, title · url · quote) |
verdict_counts | object | 판정 값별 개수(띄우지 않은 판정 포함) |
unchecked[] | array | 확인하지 못한 주장(최대 50): claim_id · sentence_id · text · label(이유) |
incomplete[] | array | 일부를 확인하지 못했을 때만: message |
timings_ms.total | number | 처리 시간(ms) |
202긴 초안의 비동기 작업(계약 매체 키만)
| 이름 | 타입 | 설명 |
|---|---|---|
job_id | string | 작업 id |
status | string | queued |
| 응답 머리 | 뜻 |
|---|---|
X-Daily-Limit | 하루 상한 |
X-Daily-Remaining | 오늘 남은 건수 |
오류
| 코드 | 뜻 |
|---|---|
| 401 | 키가 없거나 틀림(폐기한 키 포함) |
| 422 | 요청 형식 오류(필드·길이·매개변수 조합). detail 에 위치 |
| 413 | 공개 키: 본문 6,000자 초과(세지 않음) |
| 429 | 하루 한도(1,000건) 또는 분당 한도(30) 초과. Retry-After(초) |
| 503 | 일시적으로 쓸 수 없음. Retry-After(초) |