FFmpeg Media · FFmpeg Media

Mux AudioComing Soon

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

📌 What is this：Merge audio into video (replace or add a track).

💡 When to use：Use to replace or add a soundtrack.

Endpoints

Usage	Method	Path
Submit task	POST	/v1/ffmpeg/mux
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)
audioUrl	string	Required	Audio URL (allowlist domain)
mode	string	—	replace / add audio track, default replace
webhookUrl	string	—	Completion webhook URL (optional)

Request Example

curl -X POST https://api.cqtai.com/v1/ffmpeg/mux \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "inputUrl": "https://cdn.novapi.ai/tmp/video.mp4", "audioUrl": "https://cdn.novapi.ai/tmp/track.mp3", "mode": "replace" }'
# -> { "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 0.4, billed by video length (x your user rate). Auto-refunded on failure.