Keypoint Detection Model¶
v2¶
Class: RoboflowKeypointDetectionModelBlockV2 (there are multiple versions of this block)
Warning: This block has multiple versions. Please refer to the specific version for details. You can learn more about how versions work here: Versioning
Run inference on a keypoint detection model hosted on or uploaded to Roboflow.
You can query any model that is private to your account, or any public model available on Roboflow Universe.
You will need to set your Roboflow API key in your Inference environment to use this block. To learn more about setting your Roboflow API key, refer to the Inference documentation.
Type identifier¶
Use the following identifier in step "type" field: roboflow_core/roboflow_keypoint_detection_model@v2to add the block as
as step in your workflow.
Properties¶
| Name | Type | Description | Refs |
|---|---|---|---|
name |
str |
Enter a unique identifier for this step.. | ❌ |
model_id |
str |
Roboflow model identifier.. | ✅ |
confidence |
float |
Confidence threshold for predictions.. | ✅ |
keypoint_confidence |
float |
Confidence threshold to predict a keypoint as visible.. | ✅ |
class_filter |
List[str] |
List of accepted classes. Classes must exist in the model's training set.. | ✅ |
iou_threshold |
float |
Minimum overlap threshold between boxes to combine them into a single detection, used in NMS. Learn more.. | ✅ |
max_detections |
int |
Maximum number of detections to return.. | ✅ |
class_agnostic_nms |
bool |
Boolean flag to specify if NMS is to be used in class-agnostic mode.. | ✅ |
max_candidates |
int |
Maximum number of candidates as NMS input to be taken into account.. | ✅ |
disable_active_learning |
bool |
Boolean flag to disable project-level active learning for this block.. | ✅ |
active_learning_target_dataset |
str |
Target dataset for active learning, if enabled.. | ✅ |
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 Keypoint Detection Model in version v2.
- inputs:
Stitch Images,Image Threshold,Email Notification,Corner Visualization,Image Blur,Ellipse Visualization,OpenAI,Roboflow Dataset Upload,Depth Estimation,Dimension Collapse,Absolute Static Crop,Multi-Label Classification Model,JSON Parser,Google Gemini,Stability AI Image Generation,Grid Visualization,Dynamic Crop,Image Slicer,Image Preprocessing,Relative Static Crop,SIFT,Morphological Transformation,Line Counter Visualization,Trace Visualization,Detection Event Log,Halo Visualization,Dot Visualization,Model Monitoring Inference Aggregator,Keypoint Detection Model,Roboflow Custom Metadata,Pixel Color Count,Pixelate Visualization,Circle Visualization,Image Convert Grayscale,Icon Visualization,QR Code Generator,Semantic Segmentation Model,S3 Sink,Twilio SMS Notification,Halo Visualization,Camera Focus,SIFT Comparison,Anthropic Claude,Polygon Visualization,Text Display,Detections Consensus,Reference Path Visualization,Instance Segmentation Model,Identify Changes,Llama 3.2 Vision,Crop Visualization,Roboflow Dataset Upload,Mask Visualization,Heatmap Visualization,Webhook Sink,Label Visualization,Classification Label Visualization,Detections List Roll-Up,Florence-2 Model,Florence-2 Model,VLM As Detector,Polygon Zone Visualization,Stability AI Inpainting,VLM As Classifier,Google Gemini,Perspective Correction,Camera Calibration,Anthropic Claude,OpenAI,Distance Measurement,OpenAI,VLM As Detector,PTZ Tracking (ONVIF),Background Color Visualization,Template Matching,Anthropic Claude,Size Measurement,Email Notification,Background Subtraction,Contrast Equalization,SIFT Comparison,Keypoint Visualization,Line Counter,Single-Label Classification Model,Identify Outliers,Line Counter,Color Visualization,Motion Detection,Dynamic Zone,Object Detection Model,Roboflow Vision Events,Local File Sink,VLM As Classifier,Clip Comparison,Twilio SMS/MMS Notification,Buffer,Triangle Visualization,Clip Comparison,Blur Visualization,Bounding Box Visualization,Camera Focus,Polygon Visualization,Google Gemini,Image Slicer,Image Contours,Model Comparison Visualization,Stability AI Outpainting,Slack Notification - outputs:
Corner Visualization,Ellipse Visualization,SAM 3,Roboflow Dataset Upload,Object Detection Model,Multi-Label Classification Model,Qwen3.5-VL,Background Color Visualization,Dynamic Crop,Velocity,Instance Segmentation Model,Trace Visualization,Multi-Label Classification Model,Keypoint Visualization,Dot Visualization,ByteTrack Tracker,GLM-OCR,Model Monitoring Inference Aggregator,Detections Filter,Roboflow Custom Metadata,Keypoint Detection Model,Pixelate Visualization,Detections Merge,Circle Visualization,SmolVLM2,Icon Visualization,Single-Label Classification Model,Semantic Segmentation Model,Detections Classes Replacement,Keypoint Detection Model,Detections Transformation,SAM 3,OC-SORT Tracker,Detections Consensus,Color Visualization,SAM 3,Qwen2.5-VL,Single-Label Classification Model,Object Detection Model,Roboflow Vision Events,Instance Segmentation Model,Qwen3-VL,Crop Visualization,Roboflow Dataset Upload,Detection Offset,SORT Tracker,Triangle Visualization,Heatmap Visualization,Blur Visualization,Bounding Box Visualization,Webhook Sink,Byte Tracker,Label Visualization,Detections List Roll-Up,Florence-2 Model,Segment Anything 2 Model,Florence-2 Model,Moondream2,Model Comparison Visualization
Input and Output Bindings¶
The available connections depend on its binding kinds. Check what binding kinds
Keypoint Detection Model in version v2 has.
Bindings
-
input
images(image): The image to infer on..model_id(roboflow_model_id): Roboflow model identifier..confidence(float_zero_to_one): Confidence threshold for predictions..keypoint_confidence(float_zero_to_one): Confidence threshold to predict a keypoint as visible..class_filter(list_of_values): List of accepted classes. Classes must exist in the model's training set..iou_threshold(float_zero_to_one): Minimum overlap threshold between boxes to combine them into a single detection, used in NMS. Learn more..max_detections(integer): Maximum number of detections to return..class_agnostic_nms(boolean): Boolean flag to specify if NMS is to be used in class-agnostic mode..max_candidates(integer): Maximum number of candidates as NMS input to be taken into account..disable_active_learning(boolean): Boolean flag to disable project-level active learning for this block..active_learning_target_dataset(roboflow_project): Target dataset for active learning, if enabled..
-
output
inference_id(inference_id): Inference identifier.predictions(keypoint_detection_prediction): Prediction with detected bounding boxes and detected keypoints in form of sv.Detections(...) object.model_id(roboflow_model_id): Roboflow model id.
Example JSON definition of step Keypoint Detection Model in version v2
{
"name": "<your_step_name_here>",
"type": "roboflow_core/roboflow_keypoint_detection_model@v2",
"images": "$inputs.image",
"model_id": "my_project/3",
"confidence": 0.3,
"keypoint_confidence": 0.3,
"class_filter": [
"a",
"b",
"c"
],
"iou_threshold": 0.4,
"max_detections": 300,
"class_agnostic_nms": true,
"max_candidates": 3000,
"disable_active_learning": true,
"active_learning_target_dataset": "my_project"
}
v1¶
Class: RoboflowKeypointDetectionModelBlockV1 (there are multiple versions of this block)
Warning: This block has multiple versions. Please refer to the specific version for details. You can learn more about how versions work here: Versioning
Run inference on a keypoint detection model hosted on or uploaded to Roboflow.
You can query any model that is private to your account, or any public model available on Roboflow Universe.
You will need to set your Roboflow API key in your Inference environment to use this block. To learn more about setting your Roboflow API key, refer to the Inference documentation.
Type identifier¶
Use the following identifier in step "type" field: roboflow_core/roboflow_keypoint_detection_model@v1to add the block as
as step in your workflow.
Properties¶
| Name | Type | Description | Refs |
|---|---|---|---|
name |
str |
Enter a unique identifier for this step.. | ❌ |
model_id |
str |
Roboflow model identifier.. | ✅ |
confidence |
float |
Confidence threshold for predictions.. | ✅ |
keypoint_confidence |
float |
Confidence threshold to predict a keypoint as visible.. | ✅ |
class_filter |
List[str] |
List of accepted classes. Classes must exist in the model's training set.. | ✅ |
iou_threshold |
float |
Minimum overlap threshold between boxes to combine them into a single detection, used in NMS. Learn more.. | ✅ |
max_detections |
int |
Maximum number of detections to return.. | ✅ |
class_agnostic_nms |
bool |
Boolean flag to specify if NMS is to be used in class-agnostic mode.. | ✅ |
max_candidates |
int |
Maximum number of candidates as NMS input to be taken into account.. | ✅ |
disable_active_learning |
bool |
Boolean flag to disable project-level active learning for this block.. | ✅ |
active_learning_target_dataset |
str |
Target dataset for active learning, if enabled.. | ✅ |
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 Keypoint Detection Model in version v1.
- inputs:
Stitch Images,Image Threshold,Email Notification,Corner Visualization,Image Blur,Ellipse Visualization,OpenAI,Roboflow Dataset Upload,Depth Estimation,Dimension Collapse,Absolute Static Crop,Multi-Label Classification Model,JSON Parser,Google Gemini,Stability AI Image Generation,Grid Visualization,Dynamic Crop,Image Slicer,Image Preprocessing,Relative Static Crop,SIFT,Morphological Transformation,Line Counter Visualization,Trace Visualization,Detection Event Log,Halo Visualization,Dot Visualization,Model Monitoring Inference Aggregator,Keypoint Detection Model,Roboflow Custom Metadata,Pixel Color Count,Pixelate Visualization,Circle Visualization,Image Convert Grayscale,Icon Visualization,QR Code Generator,Semantic Segmentation Model,S3 Sink,Twilio SMS Notification,Halo Visualization,Camera Focus,SIFT Comparison,Anthropic Claude,Polygon Visualization,Text Display,Detections Consensus,Reference Path Visualization,Instance Segmentation Model,Identify Changes,Llama 3.2 Vision,Crop Visualization,Roboflow Dataset Upload,Mask Visualization,Heatmap Visualization,Webhook Sink,Label Visualization,Classification Label Visualization,Detections List Roll-Up,Florence-2 Model,Florence-2 Model,VLM As Detector,Polygon Zone Visualization,Stability AI Inpainting,VLM As Classifier,Google Gemini,Perspective Correction,Camera Calibration,Anthropic Claude,OpenAI,Distance Measurement,OpenAI,VLM As Detector,PTZ Tracking (ONVIF),Background Color Visualization,Template Matching,Anthropic Claude,Size Measurement,Email Notification,Background Subtraction,Contrast Equalization,SIFT Comparison,Keypoint Visualization,Line Counter,Single-Label Classification Model,Identify Outliers,Line Counter,Color Visualization,Motion Detection,Dynamic Zone,Object Detection Model,Roboflow Vision Events,Local File Sink,VLM As Classifier,Clip Comparison,Twilio SMS/MMS Notification,Buffer,Triangle Visualization,Clip Comparison,Blur Visualization,Bounding Box Visualization,Camera Focus,Polygon Visualization,Google Gemini,Image Slicer,Image Contours,Model Comparison Visualization,Stability AI Outpainting,Slack Notification - outputs:
Image Threshold,Email Notification,Corner Visualization,Image Blur,Ellipse Visualization,OpenAI,Roboflow Dataset Upload,Time in Zone,Stitch OCR Detections,Depth Estimation,CogVLM,Google Gemini,Stability AI Image Generation,Time in Zone,Dynamic Crop,Instance Segmentation Model,Image Preprocessing,Velocity,Morphological Transformation,Line Counter Visualization,Trace Visualization,LMM For Classification,Halo Visualization,Dot Visualization,ByteTrack Tracker,GLM-OCR,Polygon Visualization,Model Monitoring Inference Aggregator,Cache Get,Roboflow Custom Metadata,Pixel Color Count,Pixelate Visualization,Circle Visualization,Icon Visualization,QR Code Generator,S3 Sink,Detections Classes Replacement,Twilio SMS Notification,Halo Visualization,Anthropic Claude,SAM 3,OC-SORT Tracker,Polygon Visualization,Text Display,Detections Consensus,Reference Path Visualization,Instance Segmentation Model,Llama 3.2 Vision,Roboflow Dataset Upload,Crop Visualization,Mask Visualization,Detection Offset,CLIP Embedding Model,SORT Tracker,Heatmap Visualization,Webhook Sink,Cache Set,Google Vision OCR,Label Visualization,Classification Label Visualization,Byte Tracker,Detections List Roll-Up,Florence-2 Model,Segment Anything 2 Model,Florence-2 Model,Polygon Zone Visualization,Stability AI Inpainting,Google Gemini,SAM 3,Perspective Correction,Anthropic Claude,OpenAI,OpenAI,PTZ Tracking (ONVIF),Background Color Visualization,Anthropic Claude,Size Measurement,Email Notification,SIFT Comparison,Contrast Equalization,Keypoint Visualization,Time in Zone,Line Counter,Path Deviation,Detections Filter,Stitch OCR Detections,LMM,Detections Merge,Detections Transformation,Perception Encoder Embedding Model,Line Counter,SAM 3,Seg Preview,Color Visualization,OpenAI,Roboflow Vision Events,Local File Sink,Detections Stitch,Twilio SMS/MMS Notification,YOLO-World Model,Triangle Visualization,Clip Comparison,Bounding Box Visualization,Blur Visualization,Distance Measurement,Google Gemini,Path Deviation,Moondream2,Model Comparison Visualization,Stability AI Outpainting,Slack Notification
Input and Output Bindings¶
The available connections depend on its binding kinds. Check what binding kinds
Keypoint Detection Model in version v1 has.
Bindings
-
input
images(image): The image to infer on..model_id(roboflow_model_id): Roboflow model identifier..confidence(float_zero_to_one): Confidence threshold for predictions..keypoint_confidence(float_zero_to_one): Confidence threshold to predict a keypoint as visible..class_filter(list_of_values): List of accepted classes. Classes must exist in the model's training set..iou_threshold(float_zero_to_one): Minimum overlap threshold between boxes to combine them into a single detection, used in NMS. Learn more..max_detections(integer): Maximum number of detections to return..class_agnostic_nms(boolean): Boolean flag to specify if NMS is to be used in class-agnostic mode..max_candidates(integer): Maximum number of candidates as NMS input to be taken into account..disable_active_learning(boolean): Boolean flag to disable project-level active learning for this block..active_learning_target_dataset(roboflow_project): Target dataset for active learning, if enabled..
-
output
inference_id(string): String value.predictions(keypoint_detection_prediction): Prediction with detected bounding boxes and detected keypoints in form of sv.Detections(...) object.
Example JSON definition of step Keypoint Detection Model in version v1
{
"name": "<your_step_name_here>",
"type": "roboflow_core/roboflow_keypoint_detection_model@v1",
"images": "$inputs.image",
"model_id": "my_project/3",
"confidence": 0.3,
"keypoint_confidence": 0.3,
"class_filter": [
"a",
"b",
"c"
],
"iou_threshold": 0.4,
"max_detections": 300,
"class_agnostic_nms": true,
"max_candidates": 3000,
"disable_active_learning": true,
"active_learning_target_dataset": "my_project"
}