ForHosting KIT · Entwickler-Tools

ACR-TI-RADS-Rechner

ACR TI-RADS, das Thyroid Imaging Reporting and Data System des American College of Radiology, vergibt ganze Punkte an einen Schilddrüsenknoten aus fünf Ultraschalldeskriptoren: Zusammensetzung, Echogenität, Form, Rand und echogene Herde.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Dieser Rechner wendet die Tabelle des Tessler-Weißbuchs von 2017 an, addiert jene Punkte und ordnet die Summe TR1 bis TR5 zu, mit der Risikobeschriftung und den größenbasierten FNA- oder Verlaufsschwellen jeder Kategorie. Jedes Merkmal ist Pflicht; ein fehlender oder unerkannter Wert scheitert mit invalid_input, statt einen Score zu erfinden. Dieselbe reine Abfrage speist das kostenlose Browser-widget und die Prepaid-API, sodass Lehrakten und Automatisierung nie auseinanderlaufen. Erfolgreiche API-Elemente kosten $0.002. Das ist eine pädagogische Befundhilfe, keine Diagnose und kein Ersatz für den Radiologen.

So verwenden Sie das Werkzeug

Geben Sie Ihre Werte in das Formular oben ein. Das Werkzeug prüft sie vor der Berechnung und zeigt das Ergebnis auf derselben Seite.

Eingaben prüfen

Beachten Sie die Beschriftungen und Einheiten der Felder. Fehlt etwas oder liegt ein Wert außerhalb des erlaubten Bereichs, zeigt die Seite das zu korrigierende Feld.

Erneut berechnen oder automatisieren

Nutzen Sie das Web-Werkzeug für einzelne Prüfungen und die API, wenn Sie dieselbe Funktion automatisieren möchten.

Anwendungsfälle

Sofort ein Ergebnis erhalten

Geben Sie einen Satz Werte ein und sehen Sie das Ergebnis ohne Tabellenkalkulation oder Skript.

Szenarien vergleichen

Ändern Sie jeweils einen Wert und berechnen Sie erneut, um den Einfluss auf das Ergebnis zu sehen.

Wiederholte Aufgaben automatisieren

Nutzen Sie die API, wenn dieselbe Berechnung in Ihrem Produkt oder Ablauf laufen soll.

Häufige Fragen

Wie wird der ACR-TI-RADS-Score berechnet?

ACR TI-RADS addiert veröffentlichte Punkte aus fünf Ultraschallmerkmalen: Zusammensetzung, Echogenität, Form, Rand und echogene Herde. Sind mehrere Herdtypen vorhanden, werden die Punkte addiert. Die ganzzahlige Summe entspricht TR1 bis TR5.

Was geschieht, wenn ein Merkmal fehlt?

Die Anfrage scheitert mit invalid_input unter Nennung des fehlenden Felds. Eine TI-RADS-Summe ohne alle fünf Deskriptoren ist keine TI-RADS-Summe, und dieser Fehler wird nicht berechnet.

Wie hängen TR-Stufen mit den FNA-Größenschwellen zusammen?

TR1 und TR2 haben keine FNA-Empfehlung. TR3 nutzt FNA bei 2.5 cm und Verlauf bei 1.5 cm; TR4 nutzt 1.5 cm und 1.0 cm; TR5 nutzt 1.0 cm und 0.5 cm. Der Knotendurchmesser ist hier keine Eingabe.

Kann ich mehr als einen Typ echogener Herde senden?

Ja. Senden Sie ein array oder eine kommagetrennte Zeichenkette; Punkte aus Makrokalzifikationen, peripheren Verkalkungen und punktförmigen Herden werden addiert, passend zum Weißbuch von 2017.

Ist das eine Diagnose, und was kostet der TI-RADS-Rechner?

Nein. Es ist eine pädagogische Befundhilfe, kein Medizinprodukt. Das Browserwerkzeug läuft kostenlos auf Ihrem Gerät. API-Aufrufe nutzen Prepaid-KIT-Guthaben zu $0.002 je erfolgreichem Element; Validierungsfehler werden nicht berechnet.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/health/tirads

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/health/tirads \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"composition":"solid","echogenicity":"hypoechoic","shape":"wider_than_tall","margin":"smooth","echogenic_foci":"none_or_large_comet_tail"}'

const res = await fetch("https://api.kit.forhosting.com/health/tirads", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "composition": "solid",
    "echogenicity": "hypoechoic",
    "shape": "wider_than_tall",
    "margin": "smooth",
    "echogenic_foci": "none_or_large_comet_tail"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/health/tirads",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "composition": "solid",
    "echogenicity": "hypoechoic",
    "shape": "wider_than_tall",
    "margin": "smooth",
    "echogenic_foci": "none_or_large_comet_tail"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/tirads", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"composition":"solid","echogenicity":"hypoechoic","shape":"wider_than_tall","margin":"smooth","echogenic_foci":"none_or_large_comet_tail"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"composition":"solid","echogenicity":"hypoechoic","shape":"wider_than_tall","margin":"smooth","echogenic_foci":"none_or_large_comet_tail"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/tirads", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "composition": "solid",
  "echogenicity": "hypoechoic",
  "shape": "wider_than_tall",
  "margin": "smooth",
  "echogenic_foci": "none_or_large_comet_tail"
}

Beispiel-Antwort

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

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →