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.supervise.ly/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
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

Trusted by Fortune 500. Used by 60,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