FFmpeg Media · FFmpeg

Media ProbeNEW

📌 What is this：Extract media metadata: duration / resolution / bitrate / codec. Returns instantly.

💡 When to use：Use to inspect file properties before processing.

Endpoints

Usage	Method	Path
Submit task	POST	/v1/ffmpeg/probe
Query Result	GET	/v1/ffmpeg/info?id={taskId}

⏱ Recommended polling interval：Poll every 3-5s (response includes progress 0-100) until status = succeeded / failed. status = queued means the task is enqueued and waiting to start (not charged yet) — just keep polling. Single-task timeout is 300s with auto-refund.

Request Parameters

Param	Type	Required	Description
inputUrl	string	Required	Input media URL on a trusted allowlist domain (platform CDN or a trusted-source CDN); upload first to obtain one, or use an asset URL already on a trusted CDN

Request Example

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/veo31/1788164205419_de868f9d69d445baaf577d42e87a236f.mp4" }'
# -> { "code":200, "data":"<taskId>" }

Response Example

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