​
Setup

1

Setting up account

Sign up and get your API key
2

Login with your API key

sieve login

​
Submitting your first Sieve Job

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

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-public-data/assets/docs/quickstart-example-video.mp4"},
      "target_language": "spanish"
    }
  }'
This will return a response containing a Job ID as id, along with the job status and other details.
2

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.
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.