## Basic model info

Model name: ultralytics/yolo26-pose
Model description: Ultralytics YOLO26 pose estimation (COCO-Pose), selectable size n/s/m/l/x.


## Model inputs

- image (required): Input image (string)
- model_size (optional): Model size (n=nano, s=small, m=medium, l=large, x=extra-large) (string)
- conf (optional): Confidence threshold (number)
- iou (optional): IoU threshold for NMS (number)
- imgsz (optional): Image size (integer)
- return_json (optional): Return keypoint detections as JSON (boolean)


## Model output schema

{
  "type": "object",
  "title": "Output",
  "properties": {
    "image": {
      "type": "string",
      "title": "Image",
      "format": "uri"
    },
    "json_str": {
      "type": "string",
      "title": "Json Str"
    }
  },
  "description": "Output model for predictions."
}

If the input or output schema includes a format of URI, it is referring to a file.


## Example inputs and outputs

Use these example outputs to better understand the types of inputs the model accepts, and the types of outputs the model returns:

### Example (https://replicate.com/p/jwb9btx99nrmw0cyzvws7kmcmr)

#### Input

```json
{
  "iou": 0.45,
  "conf": 0.25,
  "image": "https://replicate.delivery/pbxt/PKzAsoTcDuZDCokMpFdYBpOZQWunNASbTVoBiAOM0pDfylTK/zidane.jpg",
  "imgsz": 640,
  "model_size": "n",
  "return_json": false
}
```

#### Output

```json
{
  "image": "https://replicate.delivery/xezq/FFFYzN6Z11JXJB4IhwOHSMzTlmTuvPipenhINVsOLCTdftyWA/output.png",
  "json_str": null
}
```


### Example (https://replicate.com/p/gqfkkz25w5rmy0cyzvyb194538)

#### Input

```json
{
  "iou": 0.45,
  "conf": 0.25,
  "image": "https://replicate.delivery/pbxt/PKzDaMbjWOfyM0WOyIkrgEOq5syHzsE4rnMmNeABQEdCnQbO/bus.jpg",
  "imgsz": 640,
  "model_size": "n",
  "return_json": false
}
```

#### Output

```json
{
  "image": "https://replicate.delivery/xezq/AedY9pehCasmpEiQixf1esBp0eFZ7crfhoX2GiokNeSKTAXZLA/output.png",
  "json_str": null
}
```


## Model readme

> [![Ultralytics YOLO banner](https://raw.githubusercontent.com/ultralytics/assets/main/yolov8/banner-yolov8.png)](https://www.ultralytics.com/yolo/yolo27?utm_source=github&utm_medium=social&utm_campaign=yolo27-launch-2026&utm_content=banner)
> 
> [中文](https://docs.ultralytics.com/zh) | [한국어](https://docs.ultralytics.com/ko) | [日本語](https://docs.ultralytics.com/ja) | [Русский](https://docs.ultralytics.com/ru) | [Deutsch](https://docs.ultralytics.com/de) | [Français](https://docs.ultralytics.com/fr) | [Español](https://docs.ultralytics.com/es) | [Português](https://docs.ultralytics.com/pt) | [Türkçe](https://docs.ultralytics.com/tr) | [Tiếng Việt](https://docs.ultralytics.com/vi) | [العربية](https://docs.ultralytics.com/ar)
> 
> [![Ultralytics CI](https://github.com/ultralytics/ultralytics/actions/workflows/ci.yml/badge.svg)](https://github.com/ultralytics/ultralytics/actions/workflows/ci.yml) [![Ultralytics Downloads](https://img.shields.io/pepy/dt/ultralytics?color=blue)](https://clickpy.clickhouse.com/dashboard/ultralytics) [![Ultralytics Discord](https://img.shields.io/discord/1089800235347353640?logo=discord&logoColor=white&label=Discord&color=blue)](https://discord.com/invite/ultralytics) [![Ultralytics Forums](https://img.shields.io/discourse/users?server=https%3A%2F%2Fcommunity.ultralytics.com&logo=discourse&label=Forums&color=blue)](https://community.ultralytics.com) [![Ultralytics Reddit](https://img.shields.io/reddit/subreddit-subscribers/ultralytics?style=flat&logo=reddit&logoColor=white&label=Reddit&color=blue)](https://www.reddit.com/r/ultralytics/)
> 
> # Ultralytics YOLO26 Pose Estimation
> 
> [Ultralytics](https://www.ultralytics.com) creates cutting-edge, state-of-the-art (SOTA) [YOLO models](https://www.ultralytics.com/yolo) built on years of foundational research in computer vision and AI. [YOLO26](https://docs.ultralytics.com/models/yolo26) is the latest generation — **fast**, **accurate**, and **easy to use**. This Replicate deployment runs YOLO26 on CPU with a runtime-selectable model size (n/s/m/l/x); this endpoint performs [pose estimation](https://docs.ultralytics.com/tasks/pose), detecting human body keypoints and skeletons for the [COCO-Pose](https://docs.ultralytics.com/datasets/pose/coco) 'person' class.
> 
> Find detailed documentation in the [Ultralytics Docs](https://docs.ultralytics.com). Get support via [GitHub Issues](https://github.com/ultralytics/ultralytics/issues/new/choose). Join discussions on [Discord](https://discord.com/invite/ultralytics), [Reddit](https://www.reddit.com/r/ultralytics/), and the [Ultralytics Community Forums](https://community.ultralytics.com)!
> 
> Request an Enterprise License for commercial use at [Ultralytics Licensing](https://www.ultralytics.com/license).
> 
> [![YOLO26 performance plots](https://raw.githubusercontent.com/ultralytics/assets/refs/heads/main/yolo/performance-comparison.png)](https://platform.ultralytics.com/ultralytics/yolo26)
> 
> ## 📄 Documentation
> 
> For comprehensive guidance on training, validation, prediction, and deployment, refer to the full [Ultralytics Docs](https://docs.ultralytics.com).
> 
> ### Install
> 
> Install the `ultralytics` package, including all [requirements](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml), in a [**Python>=3.8**](https://www.python.org/) environment with [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/).
> 
> [![PyPI - Version](https://img.shields.io/pypi/v/ultralytics?logo=pypi&logoColor=white)](https://pypi.org/project/ultralytics/) [![Ultralytics Downloads](https://img.shields.io/pepy/dt/ultralytics?color=blue)](https://clickpy.clickhouse.com/dashboard/ultralytics) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ultralytics?logo=python&logoColor=gold)](https://pypi.org/project/ultralytics/)
> 
> ```bash
> pip install ultralytics
> ```
> 
> For alternative installation methods, including [Conda](https://anaconda.org/conda-forge/ultralytics), [Docker](https://hub.docker.com/r/ultralytics/ultralytics), and building from source via Git, please consult the [Quickstart Guide](https://docs.ultralytics.com/quickstart).
> 
> ### CLI
> 
> You can run this model from the Command Line Interface (CLI) with the `yolo` command:
> 
> ```bash
> yolo predict model=yolo26n-pose.pt source='https://ultralytics.com/images/bus.jpg'
> ```
> 
> The `yolo` command supports various tasks and modes, accepting additional arguments like `imgsz=640`. See the [CLI Docs](https://docs.ultralytics.com/usage/cli).
> 
> ### Python
> 
> You can also run the model directly in Python:
> 
> ```python
> from ultralytics import YOLO
> 
> # Load the pretrained YOLO26-pose model
> model = YOLO("yolo26n-pose.pt")
> 
> # Run inference on an image
> results = model("path/to/image.jpg")
> results[0].show()  # display the annotated result
> results[0].save("output.png")  # save it
> ```
> 
> Discover more in the [Python Docs](https://docs.ultralytics.com/usage/python).
> 
> ## ✨ Model
> 
> See the [Pose Estimation Docs](https://docs.ultralytics.com/tasks/pose) for usage examples. These models are trained on [COCO-Pose](https://docs.ultralytics.com/datasets/pose/coco), focusing on the 'person' class. All models download automatically from the latest Ultralytics [release](https://github.com/ultralytics/assets/releases) on first use.
> 
> | Model                                                                                          | size (pixels) | mAP<sup>pose</sup><sub>50-95</sub><br>(e2e) | mAP<sup>pose</sup><sub>50</sub><br>(e2e) | Speed CPU ONNX (ms) | Speed T4 TensorRT10 (ms) | params (M) | FLOPs (B) |
> | ---------------------------------------------------------------------------------------------- | ------------- | ------------------------------------------- | ---------------------------------------- | ------------------- | ------------------------ | ---------- | --------- |
> | [YOLO26n-pose](https://github.com/ultralytics/assets/releases/download/v8.4.0/yolo26n-pose.pt) | 640           | 57.2                                        | 83.3                                     | 40.3 ± 0.5          | 1.8 ± 0.0                | 2.9        | 7.5       |
> | [YOLO26s-pose](https://github.com/ultralytics/assets/releases/download/v8.4.0/yolo26s-pose.pt) | 640           | 63.0                                        | 86.6                                     | 85.3 ± 0.9          | 2.7 ± 0.0                | 10.4       | 23.9      |
> | [YOLO26m-pose](https://github.com/ultralytics/assets/releases/download/v8.4.0/yolo26m-pose.pt) | 640           | 68.8                                        | 89.6                                     | 218.0 ± 1.5         | 5.0 ± 0.1                | 21.5       | 73.1      |
> | [YOLO26l-pose](https://github.com/ultralytics/assets/releases/download/v8.4.0/yolo26l-pose.pt) | 640           | 70.4                                        | 90.5                                     | 275.4 ± 2.4         | 6.5 ± 0.1                | 25.9       | 91.3      |
> | [YOLO26x-pose](https://github.com/ultralytics/assets/releases/download/v8.4.0/yolo26x-pose.pt) | 640           | 71.6                                        | 91.6                                     | 565.4 ± 3.0         | 12.2 ± 0.2               | 57.6       | 201.7     |
> 
> - **mAP<sup>val</sup>** values are for single-model single-scale on the [COCO Keypoints val2017](https://docs.ultralytics.com/datasets/pose/coco) dataset. Reproduce with `yolo val pose data=coco-pose.yaml device=0`
> - **Speed** metrics are averaged over dataset val images; CPU speeds measured with [ONNX](https://onnx.ai/) export, GPU speeds with [TensorRT](https://developer.nvidia.com/tensorrt). See [YOLO Performance Metrics](https://docs.ultralytics.com/guides/yolo-performance-metrics) for details.
> 
> ## 🧩 Integrations
> 
> Our key integrations with leading AI platforms extend the functionality of Ultralytics' offerings, enhancing tasks like dataset labeling, training, visualization, and model management. Discover how Ultralytics, in collaboration with partners like [Weights & Biases](https://docs.ultralytics.com/integrations/weights-biases), [Comet ML](https://docs.ultralytics.com/integrations/comet), [Roboflow](https://docs.ultralytics.com/integrations/roboflow), and [Intel OpenVINO](https://docs.ultralytics.com/integrations/openvino), can optimize your AI workflow. Explore more at [Ultralytics Integrations](https://docs.ultralytics.com/integrations).
> 
> ## 🤝 Contribute
> 
> We thrive on community collaboration! Ultralytics YOLO wouldn't be the SOTA framework it is without contributions from developers like you. Please see our [Contributing Guide](https://docs.ultralytics.com/help/contributing) to get started. We also welcome your feedback—share your experience by completing our [Survey](https://www.ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey). A huge **Thank You** 🙏 to everyone who contributes!
> 
> [![Ultralytics open-source contributors](https://raw.githubusercontent.com/ultralytics/assets/main/im/image-contributors.png)](https://github.com/ultralytics/ultralytics/graphs/contributors)
> 
> ## 📜 License
> 
> Ultralytics offers two licensing options to suit different needs:
> 
> - **AGPL-3.0 License**: This [OSI-approved](https://opensource.org/license/agpl-3.0) open-source license is perfect for students, researchers, and enthusiasts. It encourages open collaboration and knowledge sharing. See the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file for full details.
> - **Ultralytics Enterprise License**: For development and production use, this license enables seamless integration of Ultralytics software and AI models into business products and services, bypassing the open-source requirements of AGPL-3.0. To get started, please contact us via [Ultralytics Licensing](https://www.ultralytics.com/license).
> 
> ## 📞 Contact
> 
> For bug reports and feature requests related to Ultralytics software, please visit [GitHub Issues](https://github.com/ultralytics/ultralytics/issues). For questions, discussions, and community support, join our active communities on [Discord](https://discord.com/invite/ultralytics), [Reddit](https://www.reddit.com/r/ultralytics/), and the [Ultralytics Community Forums](https://community.ultralytics.com). We're here to help with all things Ultralytics!

