Quickstart

Setup

Setting up account

sieve login

Submitting your first Sieve Job

We will dub this clip about plants from English to Spanish.

Pushing a Sieve Job

Call your function via API call

Make sure to replace <your-api-key> with your API key.

API
curl -X POST \
  --url https://mango.sievedata.com/v2/push \
  -H 'X-API-Key: <your-api-key>' \
  -H 'Content-Type: application/json' \
  --data '{
    "function": "sieve/dubbing",
    "inputs": {
      "file": {"url": "https://storage.googleapis.com/sieve-prod-us-central1-public-file-upload-bucket/c27fa3e7-d590-4208-ab8e-57fe69e7a4b9/9acf16f7-be0e-4522-a933-13abcd2fd6e3-input-source_file.mp4"},
      "target_language": "spanish"
    }
  }'

This will return a response containing a Job ID as id, along with the job status and other details.

Monitoring Job Status

Note the id parameter (Job ID) from the previous step, then use the get job endpoint to fetch the job and its status.

API
    curl --request GET
    --url https://mango.sievedata.com/v2/jobs/<job-id>
    -H "X-API-Key: <your-api-key>"

Response
{
  "id":"<job-id>",
  ...
  # queued | processing | finished | error | cancelled
  "status":"processing"
  ...
}

The response will provide the job status and additional details about the job, to learn more check Sieve Job documentation.

Pushing a Sieve Job

Call your function via API call

Make sure to replace <your-api-key> with your API key.

API
curl -X POST \
  --url https://mango.sievedata.com/v2/push \
  -H 'X-API-Key: <your-api-key>' \
  -H 'Content-Type: application/json' \
  --data '{
    "function": "sieve/dubbing",
    "inputs": {
      "file": {"url": "https://storage.googleapis.com/sieve-prod-us-central1-public-file-upload-bucket/c27fa3e7-d590-4208-ab8e-57fe69e7a4b9/9acf16f7-be0e-4522-a933-13abcd2fd6e3-input-source_file.mp4"},
      "target_language": "spanish"
    }
  }'

This will return a response containing a Job ID as id, along with the job status and other details.

Monitoring Job Status

Note the id parameter (Job ID) from the previous step, then use the get job endpoint to fetch the job and its status.

API
    curl --request GET
    --url https://mango.sievedata.com/v2/jobs/<job-id>
    -H "X-API-Key: <your-api-key>"

Response
{
  "id":"<job-id>",
  ...
  # queued | processing | finished | error | cancelled
  "status":"processing"
  ...
}

The response will provide the job status and additional details about the job, to learn more check Sieve Job documentation.

Install the Sieve Python client

pip install sievedata
sieve login

Pushing a Sieve Job

Make sure to replace <your-api-key> with your API key.

Python Client
import sieve

source_file = sieve.File(url="https://storage.googleapis.com/sieve-prod-us-central1-public-file-upload-bucket/c27fa3e7-d590-4208-ab8e-57fe69e7a4b9/9acf16f7-be0e-4522-a933-13abcd2fd6e3-input-source_file.mp4")
# You can also reference a local file by its path
my_local_source_file = sieve.File("path/to/example_file.mp4") # Will automatically identify it is a local path

dubbing = sieve.function.get("sieve/dubbing")
target_language = "spanish"
output = dubbing.run(source_file, target_language)

for output_object in output:
  print(output_object.path)

Monitoring Job Status

Navigate to your Sieve Dashboard to view the job status.

For production environments, you may want to use our async API for longer-running jobs.

# Running Dubbing synchronously
dubbing = sieve.function.get("sieve/dubbing")
dubbing_job = dubbing.run(file, target_language="spanish")

Pushing a Sieve Job

Navigate to the Dubbing API Playground and upload your file.

Monitoring Job Status

You can monitor the status of your job in the playground. You can also check your Sieve Dashboard to view the job status.

For more production integration options, check out our section on webhooks.

Running a job on Sieve is that simple. You can customize parameters and test more function-specific specifications on the Dubbing API Page.

Getting Started

Integration

Concepts

Setup

Submitting your first Sieve Job

Getting Started

Integration

Concepts

​Setup

​Submitting your first Sieve Job

Setup

Submitting your first Sieve Job