Detections Classes Replacement

Class: DetectionsClassesReplacementBlockV1

Source: inference.core.workflows.core_steps.fusion.detections_classes_replacement.v1.DetectionsClassesReplacementBlockV1

Combine results of detection model with classification results performed separately for each and every bounding box.

Bounding boxes without top class predicted by classification model are discarded, for multi-label classification results, most confident label is taken as bounding box class.

Type identifier

Use the following identifier in step "type" field: roboflow_core/detections_classes_replacement@v1to add the block as as step in your workflow.

Properties

Name	Type	Description	Refs
name	str	Enter a unique identifier for this step..	❌
fallback_class_name	str	The class name to be used as a fallback if no class is predicted for a bounding box.	✅
fallback_class_id	int	The class id to be used as a fallback if no class is predicted for a bounding box;if not specified or negative, the class id will be set to 9223372036854775807.	✅

The Refs column marks possibility to parametrise the property with dynamic values available in workflow runtime. See Bindings for more info.

Available Connections

Compatible Blocks

Check what blocks you can connect to Detections Classes Replacement in version v1.

• inputs: Google Vision OCR, LMM For Classification, Detections Filter, Single-Label Classification Model, CSV Formatter, SAM 3, Seg Preview, Byte Tracker, Overlap Filter, SAM 3, SIFT Comparison, Object Detection Model, Path Deviation, Detections Combine, Email Notification, Anthropic Claude, Image Contours, Object Detection Model, Line Counter, Clip Comparison, Email Notification, Moondream2, VLM as Classifier, Model Monitoring Inference Aggregator, OCR Model, Path Deviation, LMM, Time in Zone, Roboflow Dataset Upload, Gaze Detection, Detections Consensus, OpenAI, SAM 3, VLM as Detector, Multi-Label Classification Model, Florence-2 Model, CogVLM, Roboflow Custom Metadata, Byte Tracker, Keypoint Detection Model, Stitch OCR Detections, Bounding Rectangle, Segment Anything 2 Model, Keypoint Detection Model, SIFT Comparison, Time in Zone, Line Counter, YOLO-World Model, PTZ Tracking (ONVIF).md), Detection Offset, Detections Classes Replacement, Detections Transformation, Template Matching, Roboflow Dataset Upload, Anthropic Claude, Florence-2 Model, Distance Measurement, Google Gemini, Google Gemini, EasyOCR, VLM as Detector, Dynamic Zone, Time in Zone, Twilio SMS Notification, Detections Stitch, Llama 3.2 Vision, Velocity, Slack Notification, Byte Tracker, OpenAI, Local File Sink, Instance Segmentation Model, Multi-Label Classification Model, OpenAI, Dynamic Crop, Single-Label Classification Model, Pixel Color Count, Detections Stabilizer, Webhook Sink, Instance Segmentation Model, VLM as Classifier, Perspective Correction, Detections Merge, OpenAI
• outputs: Label Visualization, Time in Zone, Line Counter, Blur Visualization, Background Color Visualization, Keypoint Visualization, Bounding Box Visualization, Detections Filter, Polygon Visualization, PTZ Tracking (ONVIF).md), Detection Offset, Pixelate Visualization, Detections Classes Replacement, Icon Visualization, Detections Transformation, Triangle Visualization, Roboflow Dataset Upload, Model Comparison Visualization, Byte Tracker, Overlap Filter, Corner Visualization, Distance Measurement, Florence-2 Model, Color Visualization, Path Deviation, Detections Combine, Halo Visualization, Size Measurement, Dynamic Zone, Circle Visualization, Time in Zone, Dot Visualization, Detections Stitch, Line Counter, Ellipse Visualization, Velocity, Model Monitoring Inference Aggregator, Byte Tracker, Path Deviation, Time in Zone, Roboflow Dataset Upload, Stability AI Inpainting, Dynamic Crop, Detections Consensus, Detections Stabilizer, Crop Visualization, Detections Merge, Florence-2 Model, Perspective Correction, Roboflow Custom Metadata, Mask Visualization, Trace Visualization, Byte Tracker, Stitch OCR Detections, Bounding Rectangle, Segment Anything 2 Model

Input and Output Bindings

The available connections depend on its binding kinds. Check what binding kinds Detections Classes Replacement in version v1 has.

Bindings

• input

  • object_detection_predictions (Union[instance_segmentation_prediction, object_detection_prediction, keypoint_detection_prediction]): The output of a detection model describing the bounding boxes that will have classes replaced..
  • classification_predictions (classification_prediction): The output of classification model for crops taken based on RoIs pointed as the other parameter.
  • fallback_class_name (string): The class name to be used as a fallback if no class is predicted for a bounding box.
  • fallback_class_id (integer): The class id to be used as a fallback if no class is predicted for a bounding box;if not specified or negative, the class id will be set to 9223372036854775807.

• output

  • predictions (Union[object_detection_prediction, instance_segmentation_prediction, keypoint_detection_prediction]): Prediction with detected bounding boxes in form of sv.Detections(...) object if object_detection_prediction or Prediction with detected bounding boxes and segmentation masks in form of sv.Detections(...) object if instance_segmentation_prediction or Prediction with detected bounding boxes and detected keypoints in form of sv.Detections(...) object if keypoint_detection_prediction.

Example JSON definition of step Detections Classes Replacement in version v1

{
    "name": "<your_step_name_here>",
    "type": "roboflow_core/detections_classes_replacement@v1",
    "object_detection_predictions": "$steps.my_object_detection_model.predictions",
    "classification_predictions": "$steps.my_classification_model.predictions",
    "fallback_class_name": "unknown",
    "fallback_class_id": 77
}