First, please make sure you have signed up for a Sieve account as per the quickstart guide.

Install the Sieve CLI

pip install

Then, export your Sieve API key as an environment variable. You can find your API key in the Sieve dashboard.


Create a Workflow

Create a new folder and add the files below.

import sieve
from typing import Dict, Tuple
from yolo import Yolo
from splitter import VideoSplitter

def yolo_workflow(video: sieve.Video) -> Dict:
    images = VideoSplitter(video)
    yolo_outputs = Yolo()(images)
    return yolo_outputs

Deploy the Workflow

You workflow will be deployed. You can monitor the status via your terminal or on the Sieve dashboard.

sieve deploy

Run the Workflow

You can run the workflow on a video file. You can do this via the dashboard, the API, or the CLI. We can use this file to test.


sieve push yolo_object_detection '{"video": {"url": ""}}'


curl --request POST \
    --url \
    --header "X-API-Key: $SIEVE_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "workflow_name": "yolo_object_detection",
      "inputs": {
        "video": {
          "url": ""


Navigate to the yolo_object_detection worklow on the dashboard, enter the video URL, and click Send Request.

More Examples

You can find more examples in the Sieve Examples Repo.