AI Bridge logo
Docs

How AI Bridge works

This page walks through the end-to-end flow—from uploading a scan to running TotalSegmentator analyses, exploring overlays, sharing with guests, and downloading results.

Upload & privacy by default

Send CT/MRI/dental studies from the browser or extension with de-identification before upload.

Dispatch advanced analyses

Run TotalSegmentator tasks on demand and choose only the structures you need.

Share with confidence

Create expiring links or email invites for an interactive viewer with no login required.

What you can do

AI Bridge is a secure viewer and orchestration layer for medical imaging. It accepts DICOM studies, runs organ-level segmentation models, and lets you share curated views without exposing PHI.

Fast sharing options

  • • Create 24-hour links for quick collaboration.
  • • Email a guest directly—no login or access codes required.
  • • Choose whether to include layout, opacity, and camera view in the shared session.

Model dispatch on demand

  • • Choose specific organs or packages instead of running everything.
  • • See pricing per task and what is already complete.
  • • Academic licenses for TotalSegmentator are supported where applicable.

Typical workflow

1) Create a fingerprint

Upload a scan to generate a unique voxel fingerprint and group all runs for auditing.

2) Share securely

Create a shareable link or one-time guest invite and decide what viewer state is included.

3) Dispatch analyses

Launch additional TotalSegmentator tasks without re-uploading and track what is already done.

4) Review slices and 3D meshes

Inspect orthogonal slices, adjust overlays, and isolate structures in the 3D viewer.

5) Download or keep collaborating

Download archives/meshes, re-share the fingerprint, or continue dispatching models.

Tip: you can always return to Usage sessions to track active runs, share links again, or dispatch more analyses on the same fingerprint.

Use your API key in your own apps

TotalSegmentator's Slicer integration talks to AI Bridge over the public API using the same key you generate in the dashboard. You can mirror the same pattern from any service.

Common use cases

  • • Background processors that preflight /preauth before uploading scans.
  • • PACS exports or cloud triggers that attach a fingerprint and send a gzip series to /api/segment.
  • • Custom dashboards that poll /status/<sessionId> while users wait.

How to call the API

  1. Generate an API key in AI Bridge and keep it safe.
  2. POST to /api/segment/preauth with task name, input size, and fingerprint.
  3. Use the returned upload directive to stream the study or reuse an object key.
  4. Poll statusUrl or /status/<sessionId> until completion, then download outputs.

Example: requesting upload authorization

This mirrors the headers and payload used by the TotalSegmentator module when preparing an upload.

curl -X POST https://aibridge.edit8.com/api/segment/preauth \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "total",
    "bytesIn": 134217728,
    "fingerprint": "your-fingerprint-id",
    "sourceHash": "hash-of-your-upload"
  }'

If you need queued or premium processing, add processingMode and set queued or premium to match your workflow.

Viewer controls

The browser viewer combines high-resolution 2D slices with a real-time 3D renderer so you can inspect scans without leaving the web app.

Orthogonal slices

Navigate axial, coronal, and sagittal planes with synchronized controls.

Segmentation overlays

Search labels, hide/show groups, and tune opacity per structure.

Interactive 3D viewer

Rotate, zoom, and focus on selected structures with metadata in context.

Downloads

Get archive and mesh bundles tied to the fingerprint for consistent collaboration.

Governance & traceability

Each action is recorded against the fingerprint so you know what was shared, run, and downloaded.

Fingerprint groups

Every upload gets a stable fingerprint ID so related runs stay organized together.

Run transparency

Each run captures timing, options, payload size, and output artifacts.

Access controls

Expiring links and guest invitations help teams share only what is needed.