동작 방식
모든 요청은 비동기입니다. 태스크를 제출하면 큐에 쌓이고, 워커가 대상 엔진에 질의해 결과를 추출합니다. 결과는 webhook으로 받거나 폴링으로 가져갑니다.1
태스크 제출
taskType과 payload를 담아 POST /v1/async/task를 호출합니다. 태스크 id가 즉시
QUEUED 상태로 반환됩니다.2
엔진 질의
워커가 태스크를 가져가 엔진에 질의하고, 답변 텍스트와 출처, 엔진별 추가 데이터를 추출합니다.
3
결과 수집
webhook.url을 지정했다면 결과를 그 주소로 POST합니다. 지정하지 않았다면 status가
COMPLETED 또는 FAILED가 될 때까지 GET /v1/async/task/{id}를 폴링하세요.받게 되는 결과
엔진과 관계없이 모든 결과의 핵심은 같은 형태입니다.string
엔진의 답변을 일반 텍스트로 담습니다.
array
엔진이 답변에 붙인 인용입니다.
position, url, 그리고 대개 label을 포함합니다.Base URL
/health와 /ready를 제외한 모든 엔드포인트에는 Bearer 토큰이 필요합니다.
여기서 시작하세요
첫 태스크를 제출하고 5분 안에 결과를 받아 보세요.