집계 공통 규칙 - Chainshift

인용 통계는 수집된 답변을 서버에서 집계해 상위 N개 랭킹으로 반환합니다. 목록 API와 동작 방식이 다르므로 아래 공통 규칙을 먼저 확인하세요.

공통 규칙

규칙	내용
범위 지정 필수	`runID` 또는 `promptID` 중 최소 하나. 조직 전체 집계는 불가
랭킹 방식	상위 `limit`개만 반환 (기본 50, 최대 200). cursor 페이지네이션 없음
`model` 필터	특정 모델의 답변만 집계 (선택)
시간 필터 없음	기간별 추이는 실행을 정기 제출하고 실행별 통계를 비교하는 방식으로

include 옵트인

무거운 필드는 기본 제외이며 include=로 요청합니다(반복 지정 가능).

값	엔드포인트	추가되는 것
`models`	인용 도메인 통계	도메인별 모델 분해 카운트
`quotes`	인용 URL 통계	AI가 실제 인용한 문장
`urlVariants`	인용 URL 통계	정규화로 합쳐진 원본 URL 목록

자주 묻는 질문

결과가 비어 있습니다. ① 실행이 아직 진행 중이거나(상태 확인), ② 지정 범위에 출처를 제공한 성공 답변이 없거나, ③ fan-out 통계를 fan-out 미지원 모델(지원 모델 참고)로만 조회한 경우입니다. 존재하지 않거나 내 조직이 아닌 ID를 지정해도 404가 아니라 빈 결과가 반환됩니다. 실측 예시와 해석은 통계로 분석하기 가이드를 참고하세요.