add_audio

POST

/add_audio

Add audio

Request

Header Params

Body Params application/json

Example

{
  "audio_url": "https://lf3-lv-music-tos.faceu.com/obj/tos-cn-ve-2774/oYACBQRCMlWBIrZipvQZhI5LAlUFYii0RwEPh",  // Audio file URL (Required)
  "start": 0,  // Start time for audio material cropping (seconds, default 0)
  "end": 30,  // End time for audio material cropping (seconds, Optional, default is the full length of the audio)
  "draft_id": "your_draft_id",  // Draft ID (Optional, used to specify the draft to operate on)
  "volume": 0.8,  // Volume level (default 1.0)
  "target_start": 5,  // Starting position of the audio on the timeline (seconds, default 0)
  "speed": 1.2,  // Audio speed (default 1.0, >1 for acceleration, <1 for deceleration)
  "track_name": "audio_background",  // Track name (default "audio_main")
  "duration": 20,  // Total duration of the audio material (seconds), setting this can improve request speed
  "effect_type": "Energetic",  // Sound effect type
  "effect_params": [45],  // Sound effect parameters (Optional, set according to effect_type)
  "width": 1080,  // Video width (default 1080)
  "height": 1920  // Video height (default 1920)
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.capcutapi.top/cut_capcut/add_audio' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
  "audio_url": "https://lf3-lv-music-tos.faceu.com/obj/tos-cn-ve-2774/oYACBQRCMlWBIrZipvQZhI5LAlUFYii0RwEPh",  // Audio file URL (Required)
  "start": 0,  // Start time for audio material cropping (seconds, default 0)
  "end": 30,  // End time for audio material cropping (seconds, Optional, default is the full length of the audio)
  "draft_id": "your_draft_id",  // Draft ID (Optional, used to specify the draft to operate on)
  "volume": 0.8,  // Volume level (default 1.0)
  "target_start": 5,  // Starting position of the audio on the timeline (seconds, default 0)
  "speed": 1.2,  // Audio speed (default 1.0, >1 for acceleration, <1 for deceleration)
  "track_name": "audio_background",  // Track name (default "audio_main")
  "duration": 20,  // Total duration of the audio material (seconds), setting this can improve request speed
  "effect_type": "Energetic",  // Sound effect type
  "effect_params": [45],  // Sound effect parameters (Optional, set according to effect_type)
  "width": 1080,  // Video width (default 1080)
  "height": 1920  // Video height (default 1920)
}'

Responses

🟢200OK

application/json

Body

Example

{
    "error": "",
    "output": {
        "draft_id": "dfd_cat_1753843462_b4805bb9",
        "draft_url": "https://www.capcutapi.top/draft/downloader?draft_id=dfd_cat_1753843462_b4805bb9"
    },
    "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009",
    "success": true
}

Modified at 2025-08-07 09:30:13

get_audio_effect_types

add_video_keyframe