跳转到主要内容
POST
/
tasks
Error
A valid request URL is required to generate request examples
{
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}

授权

​
Authorization
string
header
必填

Bearer Token 认证，格式: Bearer {token}

请求体

application/json

任务参数

创建转码任务的请求参数

​
command
string
必填

FFmpeg 命令，支持完整命令或仅参数部分 完整命令: "ffmpeg -i https://xxx/a.mp4 -c:v libx264 output.mp4" 仅参数: "-i https://xxx/a.mp4 -c:v libx264 output.mp4" 多输出: "-i https://xxx/a.mp4 -map 0:a audio.mp3 -map 0:v video.mp4"

示例:

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

​
webhook
string

任务完成后的回调 URL，会 POST 任务详情（与 GET /tasks/:id 返回内容相同）

示例:

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

​
with_metadata
boolean

是否获取输出文件的元信息（通过 ffprobe），默认 false

响应

返回任务 ID

​
task_id
string
示例:

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