Skip to main content
POST
/
tasks
Error
A valid request URL is required to generate request examples
{
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

​
Authorization
string
header
required

Bearer Token authentication, format: Bearer {token}

Body

application/json

Task parameters

Request parameters for creating a transcoding task

​
command
string
required

FFmpeg command, supports full command or parameters only Full command: "ffmpeg -i https://xxx/a.mp4 -c:v libx264 output.mp4" Parameters only: "-i https://xxx/a.mp4 -c:v libx264 output.mp4" Multiple outputs: "-i https://xxx/a.mp4 -map 0:a audio.mp3 -map 0:v video.mp4"

Example:

"ffmpeg -i https://example.com/video.mp4 -c:v libx264 output.mp4"

​
webhook
string

Callback URL after task completion, will POST task details (same as GET /tasks/:id response)

Example:

"https://your-server.com/callback"

​
with_metadata
boolean

Whether to get output file metadata (via ffprobe), default false

Response

Returns task ID

​
task_id
string
Example:

"550e8400-e29b-41d4-a716-446655440000"