CQTAI
FFmpeg 媒体处理 · FFmpeg

媒体探测NEW

📌 这是什么：提取媒体元信息：时长 / 分辨率 / 码率 / 编码。瞬时完成。
💡 什么时候用：处理前想先了解文件参数时用。

接口地址

用途方法路径
提交任务POST/v1/ffmpeg/probe
查询结果GET/v1/ffmpeg/info?id={taskId}
⏱ 建议轮询时间：建议每 3～5 秒轮询一次（响应含 progress 0→100），直到 status = succeeded / failed。单任务超时 300 秒、超时退款。

请求参数

参数类型必填说明
inputUrlstring必填输入媒体 URL，必须为平台 CDN 白名单域名（先用 upload 上传获取）

请求示例

curl -X POST https://api.cqtai.com/v1/ffmpeg/probe \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "inputUrl": "https://cdn.novapi.ai/tmp/video.mp4" }'
# -> { "code":200, "data":"<taskId>" }

响应示例

{
  "code": 200,
  "data": {
    "status": "succeeded",
    "progress": 100,
    "resultUrl": null,
    "probe": { "durationSec": 62.5, "width": 1280, "height": 720, "vcodec": "h264", "acodec": "aac", "bitrate": 2480000 }
  }
}

计费与积分

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