FFmpeg Media · FFmpeg

Upload FileNEW

📌 What is this：Upload a media file (multipart); returns a CDN URL synchronously.

💡 When to use：The first step for every operation — turn your local file into a usable input URL.

Endpoints

Usage	Method	Path
Submit task	POST	/v1/ffmpeg/upload
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
file	file	Required	Media file, <=200MB (multipart form field)

Request Example

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" }

Response Example

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