Skip to main content
POST
正確性スコアの背後にある不正確な主張、つまりプラットフォームの FactCheck タブに表示される、 AI の回答がカテゴリについて述べた誤った記述です。フラットなページ分割リストを返すか、 group_by で 1 つのディメンションを指定してセクションに分けます。各主張は { cluster_id, claim, occurrence } に、include で追加したフィールドを加えたものです。
  • occurrence: 対象範囲の回答のうち、その主張を含むものの割合 (%)。
  • include: theme、reasoning、models、evidence、citation_sources のいずれか。
    • models[] — その主張を行っているモデル: { id, name, occurrence }。
    • evidence[] — 主張に反論する Knowledge Base のスニペット: { id, kb_path, kb_snippet, source_updated_at }。
    • citation_sources[] — その主張の原因となっている引用ページ: { href, hostname, citation_category, domain_category, snippet, citation_share }。citation_share はモデル間で均衡化されたパーセンテージで、Citations タブと一致します。
  • group_by: model、region、persona、prompt、topic、tag、theme のうち 0 または 1 つ (citation と date はスコアのディメンションのため使用できません)。空の場合 → 1 つのフラットなページ分割リスト。ディメンションを指定した場合 → 値ごとに 1 つのセクション: { <dim>: { id, name }, accuracy, accurate, inaccurate, total_claims, claims: […] }。各セクションにはその すべて の主張が含まれます。
  • filter: スコア と同じ制約付きのツリーで、model/topic/region/persona/prompt/tag に対する単一フィールドのリーフをトップレベルの and で結合したものです (否定できるのは topic のみ)。
いくつかのガードレールにより 422 (メッセージ付き) が返されます。citation_sources は group_by と併用できません (そのシェアは対象範囲に依存するため)。フラットなリストでリクエストしてください。group_by: ["tag"] は tag フィルタと組み合わせられません (タグは複数値を持つため、共起するタグのセクションがフィルタの対象外になってしまいます)。また、非常に大きな範囲 (不正確なクラスタが約 2000 件超) で model によるセクション分けを行うこともできません。期間を狭めるか filter を使用してください。
POST /v2/reports/factcheck/claims/stream は 同じリクエストボディ を受け取り、 Server-Sent Events を返します。 まず 1 つの summary イベント (info ブロック) が送信され、続いて主張ごとに 1 つの result イベントが送信されます。 limit/cursor は無視され、デフォルトではすべての結果が返されます。上限を設けるには max_results を指定します。ストリームは フラットなリストのみ に対応しています。group_by および主張ごとの evidence/citation_sources の取得は 422 を返します。セクション分けや情報を付加した主張が必要な場合は、 非ストリームのエンドポイントを使用してください。
Response (text/event-stream)

承認

​
X-API-Key
string
header
必須

ボディ

application/json

The inaccurate claims — flat + paginated, or group_by one dim to section them (all claims per section).

​
category_id
string<uuid>
必須
​
start_date
string
必須

YYYY-MM-DD, ET, inclusive

​
end_date
string
必須

YYYY-MM-DD, ET, inclusive

​
group_by
enum<string>[]

Optional single dim to section the claims (e.g. per model). Empty → one flat claim list.

Maximum array length: 1
利用可能なオプション:
model,
region,
persona,
prompt,
topic,
tag,
theme
​
filter
FilterNode · object | null

Scope which responses count (see Filtering).

​
include
enum<string>[] | null

Optional per-claim detail fields to add to each claim (see options).

利用可能なオプション:
theme,
reasoning,
models,
evidence,
citation_sources
​
limit
integer | null

Claims (or sections) per page; default 25.

必須範囲: 0 < x <= 100
​
max_results
integer | null

Stream only: cap entries returned.

必須範囲: x > 0
​
cursor
string | null

レスポンス

Successful Response

​
info
FactcheckClaimsInfo · object
必須
​
data
FactcheckClaimsRow · object[]
必須