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, or dental studies directly from the browser or our extension. Personal details are scrubbed before the files leave your device.

Dispatch advanced analyses

Run TotalSegmentator and specialized organ packages on-demand. Choose only the structures you need and see pricing before you dispatch.

Share with confidence

Create expiring links or invite guests by email. Recipients open an interactive 2D/3D viewer—no login or code 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.
• Decide whether to include the current layout, opacities, 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 which structures are 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. You can explore the viewer immediately, and every run associated with this fingerprint is grouped together for auditing.

2) Share securely

From the share panel, choose Create shareable link for a quick URL or Email a guest to send a one-time invite. Toggle the DICOM-style viewer and decide whether to include the current overlays, layout, and viewing angle in the shared experience.

3) Dispatch analyses

Use Run more analyses to launch additional TotalSegmentator tasks without re-uploading. Pick organs or packages (e.g., teeth, pleural effusion, vessels) and see which tasks are already done. Academic licenses are supported when applicable.

4) Review slices and 3D meshes

The orthogonal slice view shows axial, coronal, and sagittal planes with per-structure overlays. Adjust overlay visibility or opacity, then jump into the interactive 3D viewer to isolate segments, frame only visible structures, and inspect bounding boxes.

5) Download or continue collaborating

Each run exposes download buttons for the latest archive and mesh outputs. You can re-share the same fingerprint, keep dispatching new models, or monitor status from the Usage sessions page.

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. The module sends that key in both X-API-Keyand Authorization: Bearer headers, then calls the/api/segment endpoints to request uploads and check status. You can mirror the same pattern from any service.

Common use cases

• Background processors that preflight /preauth to get upload instructions before sending a scan.
• PACS exports or cloud storage triggers that attach a fingerprint and forward a gzip of the series to /api/segment with your key.
• Custom dashboards that poll /status/<sessionId> for progress updates while users wait.

How to call the API

Generate an API key in AI Bridge and keep it safe.
POST to /api/segment/preauth with the task name, input size, and fingerprint. Include your key in the two headers shown below.
Use the returned upload directive (URL, headers, optional session ID) to stream the study or reuse an existing S3 object key.
Poll the provided statusUrl or /status/<sessionId> endpoint until completion, then download the result tarball.

Example: requesting upload authorization

This mirrors the headers and payload the TotalSegmentator module sends when it prepares an upload. Replace the placeholder values with your fingerprint, hash, and task selection.

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"
  }'

Tip: if you need queue or premium processing, add processingModeand set it to queued or premium, matching the headers TotalSegmentator attaches when those modes are enabled.

Viewer controls

The in-browser viewer combines high-resolution 2D slices with a real-time 3D renderer. Use these controls to navigate a scan without leaving the browser.

Orthogonal slices

Navigate axial, coronal, and sagittal planes with synchronized position sliders. Quickly reset views and toggle overlays for individual labels.

Segmentation overlay controls

Search labels, hide/show groups, and fine-tune opacity per structure. Each label shows whether its mesh or overlay is visible in the current frame.

Interactive 3D viewer

Launch the WebGL viewer to spin, zoom, and focus on selected structures. Frame only visible segments and inspect per-structure metadata in the sidebar.

Downloads

Grab the latest archive or mesh bundle once a run finishes. Downloads are tied to the fingerprint so collaborators always get the right files.

Governance & traceability

Each action is recorded against the fingerprint so you know what was shared, which models ran, and when files were downloaded.

Fingerprint groups

Every upload becomes a fingerprint group with a stable ID. Runs are organized under that ID so you can trace when a scan was first seen, what models ran, and which outputs were shared.

Run transparency

Each run lists start/finish time, selected variant flags (fast, CPU/GPU preferences, verbosity), payload size, and duration. Expand a run to copy the dispatch settings or download outputs.

Access controls

Links expire automatically and guests only see the viewer you’ve configured. Teams can invite admins, audit share events, and regenerate API keys from the dashboard.