API Reference v2

Settings

Available since API version 2021-002

Parameters

NameTypeDefaultRequired
ultrafast
Enable the ultrafast mode.
The input video is split into small chunks for parallel transcoding. Speed is increased by ~x5 for 4k outputs.

It is advised to use this option for any 1080p / 4k output resolutions and for HEVC encoding.

Works only with video longer than a minute, if shorter, the option is ignored.
bool false No

Ultrafast mode example

curl https://api.coconut.co/v2/jobs \
-u your-api-key: \
-d '
{
  "settings": {
    "ultrafast": true
  },
  "input": {
    "url": "https://s3.amazonaws.com/bucket/file.avi"
  },
  "storage": {
    "service": "s3",
    "region": "us-east-1",
    "bucket": "mybucket",
    "credentials": {
      "access_key_id": "...",
      "secret_access_key": "..."
    }
  },
  "notification": {
    "type": "http",
    "url": "http://site.com/webhook"
  },
  "outputs": {
    "mp4:hevc_2160p": {
      "path": "/4k/video.mp4"
    },
    "mp4:hevc_1080p": {
      "path": "/1080p/video.mp4"
    }
  }
}'