ForHosting KIT · 開発者向けツール

絶対リスク減少率計算ツール

絶対リスク減少率計算ツールは、対照群のイベント率と治療群のイベント率を比較します。各値を0から1までの小数で入力すると、対照群の率から治療群の率を差し引きます。結果は、リスクの直接的な変化を小数とパーセントポイントの両方で示します。臨床研究の読解、エビデンス要約の確認、介入の比較、観察された効果の大きさと方向の説明に役立ち、相対リスク減少率との混同を防げます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

絶対リスク減少率が示すもの

絶対リスク減少率はARRとも略され、対照群のイベント率と治療群のイベント率の差を示します。計算式は、対照群イベント率から治療群イベント率を引くものです。対照群が0.20、治療群が0.12なら、絶対リスク減少率は0.08、すなわち8パーセントポイントです。この差から、研究期間中に治療群でイベントがどの程度少なく発生したかを直接把握できます。対照群の率を基準に差を拡大・縮小しないため、観察されたベースラインリスクに結び付いた指標です。イベントがまれな場合、大きな相対変化でも絶対変化は小さいことがあるため、この区別は重要です。正の結果は治療群のイベントが少ないこと、0は両群の率が同じこと、負の結果は治療群でイベントが多く、絶対リスク増加になったことを示します。解釈する際は、元の研究におけるイベントの定義、追跡期間、対象集団、不確実性も必ず併せて確認してください。

率の入力方法と結果の読み方

2つのイベント率は、0と1を含む範囲の割合として入力してください。15%なら15ではなく0.15と入力します。対照群イベント率は、プラセボ、通常診療、無介入、または別の基準治療を受けた比較群の値です。治療群イベント率は、評価対象の介入を受けた群の値です。計算結果には、元の2つの率、絶対リスク減少率の小数値、同じ差のパーセントポイント表記が含まれます。パーセントポイントと変化率は同じではありません。20%から12%への低下は8パーセントポイントですが、相対的な低下は40%です。両者を分けて表現すると、よくある報告上の誤りを避けられます。イベント率になり得ないため、範囲外の値は拒否されます。未入力、文字列、無限大、その他の有限でない値も使用できません。0と1は小規模標本で生じ得るため受け付けますが、極端な率は標本数や信頼区間と併せて慎重に確認してください。

結果を適切に利用するために

ARRは、イベントの実数、標本数、信頼区間、観察期間と一緒に読むと最も有用です。対照群の初期リスクが異なれば、同じ相対効果を報告する2つの研究でも、絶対減少量は異なる場合があります。そのためARRは、医療従事者、研究者、政策担当者、一般の読者が、特定集団における実際的な影響を判断する助けになります。ARRが正で0でない場合は、治療必要数の計算にも利用でき、その値はARRの逆数です。ただし、このツールはその二次指標を算出せず、因果関係の推定、交絡調整、統計的不確実性の推定も行いません。決定論的な引き算だけを実行します。負の値を便益として説明しないでください。入力されたイベントについて治療群の率が高かったことを意味します。また、イベントが有害か有益かも確認してください。回復など有益なイベントの場合は、同じ引き算よりも絶対便益増加として示すほうが明確なことがあります。

活用例

臨床試験を読み解く

報告された対照群と治療群の率を比較し、観察されたリスク差を分かりやすいパーセントポイントで確認できます。

エビデンス要約を検算する

公表された率からARRを再計算し、絶対効果が相対的な変化率と取り違えられていないか確認できます。

治療の影響を説明する

2つの小数イベント率を簡潔な絶対差に変換し、報告書、発表、共同意思決定に利用できます。

よくある質問

どの計算式を使用しますか？

対照群イベント率から治療群イベント率を差し引きます。ARR = 対照群イベント率 − 治療群イベント率です。

パーセントと小数のどちらを入力しますか？

0から1までの小数を入力してください。たとえば18%は0.18とします。結果にはパーセントポイントでの差も含まれます。

結果が負の場合は何を意味しますか？

治療群イベント率が対照群より高いことを示します。有害な転帰なら、リスク減少ではなく絶対リスク増加です。

絶対リスク減少率と相対リスク減少率は同じですか？

同じではありません。ARRは率の直接的な差です。相対リスク減少率は、その差を対照群イベント率で割ります。

この結果だけで治療効果を証明できますか？

できません。この計算は入力された2つの率を要約するものです。因果的な解釈には研究デザイン、不確実性、バイアス、対象集団、転帰、追跡期間も関係します。

APIでの計算料金はいくらですか？

APIリクエスト1件の料金は$0.002です。同じ決定論的計算をブラウザ内でも実行できます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/stat/absolute-risk-reduction

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/stat/absolute-risk-reduction \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"control_event_rate":0.2,"treatment_event_rate":0.12}'

const res = await fetch("https://api.kit.forhosting.com/stat/absolute-risk-reduction", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "control_event_rate": 0.2,
    "treatment_event_rate": 0.12
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/absolute-risk-reduction",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "control_event_rate": 0.2,
    "treatment_event_rate": 0.12
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/absolute-risk-reduction", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"control_event_rate":0.2,"treatment_event_rate":0.12}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"control_event_rate":0.2,"treatment_event_rate":0.12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/absolute-risk-reduction", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "control_event_rate": 0.2,
  "treatment_event_rate": 0.12
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.absolute_risk_reduction",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →