Aspect Ratio

{
  "input": "https://example.com/video.mp4",
  "operations": [
    { "type": "aspect_ratio", "params": { "ratio": "16:9", "mode": "pad" } }
  ]
}

{
  "id": "<string>",
  "status": "pending"
}

POST

jobs

{
  "input": "https://example.com/video.mp4",
  "operations": [
    { "type": "aspect_ratio", "params": { "ratio": "16:9", "mode": "pad" } }
  ]
}

{
  "id": "<string>",
  "status": "pending"
}

{
  "input": "https://example.com/video.mp4",
  "operations": [
    { "type": "aspect_ratio", "params": { "ratio": "16:9", "mode": "pad" } }
  ]
}

Param	Type	Description
ratio	string	Target aspect ratio (e.g., “16:9”, “4:3”, “1:1”)
mode	string	Adjustment mode: pad or crop

X-API-Key

string

header

required

application/json

input

required

Single input URL

Example:

"https://example.com/video.mp4"

operations

object[]

required

Show child attributes

Example:

[
  {
    "type": "transcode",
    "params": { "format": "mp4", "codec": "h264" }
  }
]

webhook_url

string

URL to receive job completion notification

file_size

integer

File size hint in bytes (for plan limit validation)

Job accepted

string

status

string

Example:

"pending"

⌘I