FFmpeg 媒体处理 · FFmpeg

文件上传NEW

📌 这是什么：上传媒体文件（multipart），同步直传并返回 CDN URL。

💡 什么时候用：所有操作的第一步——把你的本地文件变成平台可用的输入 URL。

接口地址

用途	方法	路径
提交任务	POST	/v1/ffmpeg/upload
查询结果	GET	/v1/ffmpeg/info?id={taskId}

⏱ 建议轮询时间：建议每 3～5 秒轮询一次（响应含 progress 0→100），直到 status = succeeded / failed。单任务超时 300 秒、超时退款。

请求参数

参数	类型	必填	说明
file	file	必填	媒体文件，≤200MB（multipart 表单字段）

请求示例

curl -X POST https://api.cqtai.com/v1/ffmpeg/upload \
  -H 'Authorization: Bearer <API_KEY>' \
  -F 'file=@/path/to/video.mp4'
# -> { "code":200, "data":"https://cdn.novapi.ai/tmp/1718700000000_ab12cd.mp4" }

响应示例

{
  "code": 200,
  "msg": "success",
  "data": "https://cdn.novapi.ai/tmp/1718700000000_ab12cd.mp4"
}

计费与积分

固定 1 积分/次（失败不扣）（× 你的用户费率）。任务失败自动退回。