API & SDK

Seamless integration with existing codebase

Integrate your existing codebase and tech stack with Supervisely via API and SDK to automate workflow.

$ curl -H "x-api-key: <token-here>" \
https://app.supervisely.com/public/api/v3/projects.list

{
"total": 12,
"perPage": 2,
"pagesCount": 6,
"entities": [
{
  "id": 1,
  "workspaceId": 1,
  "name": "lemon",
  "type": "images",
  "description": "ts12",
  "size": "861069",
  "status": "ready"
}
for dataset in cloned_project:
    print("Dataset: ", dataset.name)

    for item_name in dataset:
        ann_path = dataset.get_ann_path(item_name)
        ann = sly.Annotation.load_json_file(ann_path, cloned_project.meta)

        # Apply the filtering to find the labels to be retained.
        # Only keep Polygon labels with large enough area.
        retained_labels = [
            label for label in ann.labels
            if isinstance(label.geometry, sly.Polygon) and label.geometry.area > 120000]

        # Make a copy of the original annotation, but only keep
        # retained_labels there.
        ann_filtered = ann.clone(labels=retained_labels)

        # Update the annotation on disk.
        dataset.set_ann(item_name, ann_filtered)

Rich JSON API

Over 220 methods to retrieve, update and extract any information from the platform and even:

  • Change labeling interface for a particular user
  • Efficiently upload gigabytes of data with streams
  • Communicate with applications via websockets
View documentation

Powerful Python SDK

Not just another wrapper for API: Supervisely SDK covers every aspect of development, including:

  • Prepare data for model training and inference
  • Augment images together with annotations

In the heart of the platform

We polish our API and SDK not only because we need a way for our awesome community and customers to extend Supervisely and integrate it with existing workflows — everything from the core functionality like labeling toolboxes to Supervisely Apps is built with those toolkits.

With that you can be sure that every idea you might come up with can be easily done in Supervisely with the help of SDK and API.

Boundless customization with
Supervisely Apps

Constantly growing ecosystem of hundreds of ready-to-use apps that extend and add new functionality.

Learn about Ecosystem

SUPERVISELY FOR ENTERPRISES

On-premise edition built for your business

A fully customizable AI infrastructure, deployed on cloud or your servers with everything you love about Supervisely, plus advanced security, control, and support.

Start 30 days free trial
  • Maximum security: hosted behind firewall on your servers with advanced governance and privacy settings
  • Effortless integrations: single sign-on with LDAP or OpenID, cloud storage in AWS or Azure and powerful API & SDK
  • Priority support: dedicated slack chat, guided onboarding and personalized training sessions with experts
supervisely install
> downloading pre-requirements...
> pulling docker images...
> installing software...
> Done! Supervisely is running on port :80

supervisely update
> checking for updates...
> Your version is up to date!
Supervisely slack logo
#support
Team Manager 17:33
Hello @supervisely! Is there a way to create a project via API?
Supervisely 17:35
Sure thing, check out this docs!

Here’s why our customers trust us

Engie customer testimonial
Quote mark

We use Supervisely since 2019. The key advantage of this tool is that Supervisely provides a complete data treatment pipeline. An important advantage is that a Supervisely instance can be deployed autonomously on a Client infrastructure, and distributed on different servers.

It helps to treat enterprise’s internal and often confidential data in a secured way. Together with a user-friendly interface, a clear documentation and a friendly and reactive support team it helps us to do Data Scientist work better and faster.

engie-logo
Dmitriy Slutskiy
PhD Research Engineer
BMW customer testimonial

BMW Group is using the Supervise.ly solution to create automated verifications for ensuring a very high product quality across the whole production chain in vehicle and vehicle component manufacturing.

BMW Group uses Supervise.ly to annotate manufacturing images from production lines in their world-wide plants for enhancing quality inspections using deep learning. The Supervise.ly tooling also supports the process for continuously updating AI models using semi-automated labeling.

Supervise.ly is integrated into the BMW Group AI Platform in order to empower computer vision based AI use cases.

Surgar customer testimonial
Quote mark

We’ve been working together with Supervisely since 2020, and we have helped each other to grow rapidly and significantly.

Supervisely’s team has been incredibly fast and agile in taking on board our requirements and implementing useful, up-to-date computer vision functionalities. In addition, we appreciate the openness and scalability of their ecosystem combined with the Python SDK and API. So far, we have been very satisfied with the platform and the incredibly responsive team.

surgar-logo
Julien Peyras
Director of Data Science Department
UCD customer testimonial
Quote mark

Working with Supervise.ly has significantly enhanced our capability to develop AI models for lung CT scans. What sets Supervise.ly apart is its exceptional support team who are really responsive and adapt to our unique needs with a range of apps and helper files.

Their team has developed updates driven by our specific user feedback, making Supervise.ly a critical component of our research ecosystem in generating the specific labels we need to provide AI-driven solutions. We are immensely grateful for their pivotal role in our work.

ucd-logo
Katie Noonan
AI Research Engineer
Resson customer testimonial
Quote mark

We originally set out to look for tools that could help us with data annotation, and we discovered that Supervisely excels at that and much more. It has become an integral part of our workflow in annotation, model training, and evaluation.

We've been exceedingly impressed with the customer support, addition of new features, and the flexibility of the publicly available SDK/API. The Supervisely team has also been fast to respond to support questions, and has shown a lot of openness when given feedback on potential improvements.

resson-logo
Travis Prosser
Engineering Specialist
Toadi customer testimonial
Quote mark

We have been using Supervisely for a few years now to help label and organize our data for AI training. The interface is user-friendly and the tools are intuitive to use, which has made the annotation process much more efficient for our team. We run Supervisely locally, which allows us to stay in control of our data. We also use Supervisely for annotation reviews, and the review tools have been invaluable in ensuring the quality and accuracy. The Python SDK has also been incredibly helpful in automating and streamlining our workflow. In addition, the support team on Slack has been extremely helpful and responsive. The ability to collaborate with my colleagues on the same project has also been a huge time-saver.

Overall, we have been extremely satisfied with Supervisely and would highly recommend it to anyone in need of a reliable and efficient annotation solution.

eeve-logo
Mike Slembrouck
CTO

7

years

Supervisely provides first-rate experience since 2017, longer than most of computer vision platforms over there.

80,000+

users

Join community of thousands computer vision enthusiasts and companies of every size that use Supervisely every day.

1,000,000,000+

labels

Our online version has over a 220 million of images and over a billion of labels created by our great community.

Trusted by Fortune 500. Used by 80,000+ companies and researchers worldwide

Contact Us

Ready to get started?

Speak with people who are on the same page with you. An actual data scientist will:

  • Show live demo
  • Go through the concepts
  • Learn your case
  • Offer a tailored solution

Get you data labeled

Get accurate training data on scale with expert annotators, ML-assisted tools, dedicated project manager and the leading labeling platform.

Order workforce