把事實查核，
接進你的應用。

01 / 開始呼叫

第一個查核請求

`/api/fact-check` 是 x402 付費 API，正式預設每次查核收取 0.05 USDC。第一次呼叫會回 402；請用支援 x402 的錢包依 PAYMENT-REQUIRED 產生付款簽章， 再以 PAYMENT-SIGNATURE（或舊版 X-PAYMENT）重試相同請求。 首頁互動表單則使用下方的免費 /api/demo，不需要錢包。

// 第一次請求會回 402；用錢包依 PAYMENT-REQUIRED 產生簽章
const paymentSignature = await wallet.createPaymentSignature(/* PAYMENT-REQUIRED */);
const response = await fetch("/api/fact-check", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "PAYMENT-SIGNATURE": paymentSignature
  },
  body: JSON.stringify({
    text: "非學校型態學生，國中小以下目前沒有普遍補助"
  })
});
const result = await response.json();
console.log(result);

正式部署設定使用 Base mainnet（eip155:8453）、CDP facilitator 與 0.05 USDC；本機範例預設改用 Base Sepolia（eip155:84532）公開 facilitator。 付款簽章由錢包或 x402 client 產生，請勿在瀏覽器程式碼中放入 facilitator secret。

付費端點允許寬鬆跨來源 CORS，預檢允許 PAYMENT-SIGNATURE 與 X-PAYMENT。免費 /api/demo 仍只接受本站與既有允許清單來源， 並保留 Origin guard、CORS 與 IP 限流；預設每個 IP 每 60 秒一次，可由 RATE_LIMIT_WINDOW_MS 調整。

curl --get 'https://check.vtaiwan.tw/api/fact-check' \
  --data-urlencode 'text=非學校型態學生，國中小以下目前沒有普遍補助'

curl --get 'https://check.vtaiwan.tw/api/fact-check' \
  --data-urlencode 'text=非學校型態學生，國中小以下目前沒有普遍補助' \
  --data-urlencode 'url=https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode=A0000001'

02 / 輸入參數

一段文字，一個選填網址

POST 使用 Content-Type: application/json，請求本文上限為 128,000 bytes。沒有網址時請省略 url，不要傳空字串或 null。

03 / 讀懂回應

判斷結果，也保留證據脈絡

以下是「證據不足」的格式示例，並非對範例主張的實際查核結果。completed 表示流程完成，仍可能得到 insufficient_evidence。

{
  "text": "非學校型態學生，國中小以下目前沒有普遍補助",
  "status": "completed",
  "moderation": {
    "decision": "allow",
    "categories": []
  },
  "factuality": 0.7,
  "confidence": 0.4,
  "verdict": "mostly_supported",
  "related_checks": [],
  "feedback": "查無相關查核資料，以下為常識判斷：此主張與常見制度描述大致相符，請自行查證。",
  "meta": {
    "request_id": "example-request-id",
    "cofacts_candidates": 0,
    "cofacts_relevant": 0,
    "cofacts_human_checks": 0,
    "cofacts_ai_checks": 0,
    "url_context_used": false,
    "url_context_allowlisted": false,
    "no_relevant_evidence": true,
    "warnings": []
  }
}

factuality

0～1，表示證據支持主張的程度。它不是主張為真的機率；無證據時的 0.5 表示無法判定。

confidence

0～1，表示判斷所依據的證據是否充分、可靠且一致。應與 factuality 一起閱讀。

feedback

繁體中文說明，補充證據限制、適用範圍與需要進一步查證之處。

related_checks

相關查核陣列，以 cofacts_human／cofacts_ai 區分人工與 AI 回覆。每筆包含查核文字與 Cofacts 原文 url；有引文時另附 reference_url／reference_urls。

meta

包含 request ID、候選及證據數量、是否使用 URL 背景，以及 warnings 警告。

六種判斷結果

兩種分數各有用途：retrieval_score 只是 Cofacts 搜尋排序；relevance_score 是 0～1 的語意相關程度。兩者都不代表真假，不能直接換算 factuality。

04 / 狀態與錯誤

先看 HTTP，再看核心回應

付款放行後，查核 JSON 與核心的狀態欄位會原樣轉送；服務自身只負責付款與 proxy。 所有回應都附 X-Request-Id，並維持 Cache-Control: no-store。

`/api/demo` 另有免費入口的 FORBIDDEN_ORIGIN 與 RATE_LIMITED； 這些守護不套用到 x402 付費端點。

05 / x402 付款流程

先驗證，再轉送；成功才結算

1. 1

   收到 402

   第一次呼叫不帶付款，服務回傳 PAYMENT-REQUIRED 與繁體中文付款說明。

2. 2

   使用錢包付款

   正式預設在 Base mainnet 以 USDC 支付 0.05；本機範例使用 Base Sepolia。

3. 3

   帶簽章重試

   把 PAYMENT-SIGNATURE（或 X-PAYMENT）附在相同 GET／POST 請求重試。

4. 4

   驗證、轉送，再結算

   facilitator verify 成功後才透過 service binding 送到 fact-check-core；handler 回應 <400（本 API 通常為 2xx）才呼叫 settle。回應 >=400 時不結算，錯誤直接回客戶端。

5. 5

   保留核心回應

   核心回應本文與 X-Request-Id、Cache-Control、X-Fact-Check-Cache 等標頭原樣回傳。

x402 沒有 JWT cookie 通行證；每個付費 API 請求都要 verify。core 回 >=400 或 fetch 失敗轉 502 時不結算；core 回 2xx 但內容為錯誤仍可能結算，settle 網路失敗則需另外確認付款狀態。