FFmpeg Media · FFmpeg Media

TranscodeComing Soon

🚧 Coming soon — docs preview only, online run not yet available.

📌 What is this：Convert container format and audio/video codecs.

💡 When to use：Use to change format (e.g. mov->mp4) or codec.

Endpoints

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

⏱ Recommended polling interval：Poll every 3-5s (response includes progress 0-100) until status = succeeded / failed. Single-task timeout is 300s with auto-refund.

Request Parameters

Param	Type	Required	Description
inputUrl	string	Required	Input media URL, must be on the platform CDN allowlist (upload first to obtain it)
format	string	—	Container: mp4 / webm / mkv, default mp4
vcodec	string	—	Video codec: h264 / h265 / vp9, default h264
acodec	string	—	Audio codec: aac / opus / copy, default aac
webhookUrl	string	—	Completion webhook URL (optional)

Request Example

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

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "<taskId>",
    "operation": "transcode",
    "status": "succeeded",
    "progress": 100,
    "resultUrl": "https://cdn.novapi.ai/ffmpeg/xxx.mp4",
    "costPoints": 3,
    "errorMsg": null
  }
}

Billing & Credits

Factor 1.0; 1 min 720P ~ 3 credits (x your user rate). Auto-refunded on failure.