Skip to main content
POST
/
v1
/
video
/
transcode
{
  "input": "https://example.com/video.mp4",
  "format": "mp4",
  "codec": "h264",
  "resolution": "720p",
  "bitrate": "",
  "crf": 0
}

curl -X POST https://api.ringbee.dev/v1/video/transcode \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@video.mp4" \
  -F "format=mp4" \
  -F "codec=h264" \
  -F "resolution=720p"

{
  "id": "job_abc123",
  "status": "pending"
}
{
  "error": "<string>"
}
{
  "error": "<string>"
}
{
  "input": "https://example.com/video.mp4",
  "format": "mp4",
  "codec": "h264",
  "resolution": "720p",
  "bitrate": "",
  "crf": 0
}

curl -X POST https://api.ringbee.dev/v1/video/transcode \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@video.mp4" \
  -F "format=mp4" \
  -F "codec=h264" \
  -F "resolution=720p"
ParamTypeDescription
formatstringOutput format: mp4, webm, mkv, avi
codecstringVideo codec: h264, h265, vp9, av1
resolutionstringTarget resolution: 480p, 720p, 1080p, 4k
bitratestringTarget bitrate (e.g., “2M”)
crfintegerConstant rate factor (0-51, lower = better quality)

Authorizations

​
X-API-Key
string
header
required

Body

​
input
string
required

Input file URL

​
format
string

Output format: mp4, webm, mkv, avi

​
codec
string

Video codec: h264, h265, vp9, av1

​
resolution
string

Target resolution: 480p, 720p, 1080p, 4k

​
bitrate
string

Target bitrate (e.g., "2M")

​
crf
integer

Constant rate factor (0-51, lower = better quality)

​
webhook_url
string

URL to receive job completion notification

Response

Job accepted

​
id
string
Example:

"job_abc123"

​
status
enum<string>
Available options:
pending,
processing,
completed,
failed,
cancelled
Example:

"pending"