add_image - CapCutAPI

Add Image

Request

Header Params

Body Params application/json

Example

{
  "image_url": "https://cdn.wanx.aliyuncs.com/wanx/1719234057367822001/text_to_image_v2/d6e33c84d7554146a25b1093b012838b_0.png?x-oss-process=image/resize,w_500/watermark,image_aW1nL3dhdGVyMjAyNDExMjkwLnBuZz94LW9zcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxtX2ZpeGVkLHdfMTQ1LGhfMjU=,t_80,g_se,x_10,y_10/format,webp", // URL of the image to add
  "start": 0, // Start time of the image in the draft (seconds)
  "end": 5.0, // End time of the image in the draft (seconds)
  "width": 1920, // Width of the video display area not this image (pixels)
  "height": 1080, // Height of the image display area not this image (pixels)
  "draft_id": "", // ID of the draft to which the image will be added
  "transform_x": 0.2, // Horizontal position offset (relative to the video width)
  "transform_y": 0.2, // Vertical position offset (relative to the video height)
  "scale_x": 1, // Horizontal scaling factor
  "scale_y": 1, // Vertical scaling factor
  "track_name": "video_main", // Name of the track to which the image will be added. (default video_main)
  "relative_index": 99, // Relative position in the track (priority)
  "intro_animation": "Zoom_In", // Entrance animation effect ("Zoom In")
  "intro_animation_duration": 0.5, // Duration of the entrance animation (seconds)
  "outro_animation": "Rotate", // Exit animation effect ("Rotate")
  "outro_animation_duration": 0.5, // Duration of the exit animation (seconds)
  "transition": "Flash", // Transition effect with the next clip ("Flash")
  "transition_duration": 0.5, // Duration of the transition effect (seconds)
  "mask_type": "Rectangle", // Mask type ("Rectangle")
  "mask_center_x": 0.5, // Horizontal center position of the mask (relative to the image width)
  "mask_center_y": 0.5, // Vertical center position of the mask (relative to the image height)
  "mask_size": 0.7, // Size of the mask (relative to the image size)
  "mask_rotation": 45.0, // Rotation angle of the mask (degrees)
  "mask_feather": 2, // Feathering effect of the mask edge
  "mask_invert": true, // Whether to invert the mask
  "mask_rect_width": 8, // Border width of the rectangular mask
  "mask_round_corner": 10 // Radius of rounded corners for the rectangular mask
}

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_image' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
  "image_url": "https://cdn.wanx.aliyuncs.com/wanx/1719234057367822001/text_to_image_v2/d6e33c84d7554146a25b1093b012838b_0.png?x-oss-process=image/resize,w_500/watermark,image_aW1nL3dhdGVyMjAyNDExMjkwLnBuZz94LW9zcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxtX2ZpeGVkLHdfMTQ1LGhfMjU=,t_80,g_se,x_10,y_10/format,webp", // URL of the image to add
  "start": 0, // Start time of the image in the draft (seconds)
  "end": 5.0, // End time of the image in the draft (seconds)
  "width": 1920, // Width of the video display area not this image (pixels)
  "height": 1080, // Height of the image display area not this image (pixels)
  "draft_id": "", // ID of the draft to which the image will be added
  "transform_x": 0.2, // Horizontal position offset (relative to the video width)
  "transform_y": 0.2, // Vertical position offset (relative to the video height)
  "scale_x": 1, // Horizontal scaling factor
  "scale_y": 1, // Vertical scaling factor
  "track_name": "video_main", // Name of the track to which the image will be added. (default video_main)
  "relative_index": 99, // Relative position in the track (priority)
  "intro_animation": "Zoom_In", // Entrance animation effect ("Zoom In")
  "intro_animation_duration": 0.5, // Duration of the entrance animation (seconds)
  "outro_animation": "Rotate", // Exit animation effect ("Rotate")
  "outro_animation_duration": 0.5, // Duration of the exit animation (seconds)
  "transition": "Flash", // Transition effect with the next clip ("Flash")
  "transition_duration": 0.5, // Duration of the transition effect (seconds)
  "mask_type": "Rectangle", // Mask type ("Rectangle")
  "mask_center_x": 0.5, // Horizontal center position of the mask (relative to the image width)
  "mask_center_y": 0.5, // Vertical center position of the mask (relative to the image height)
  "mask_size": 0.7, // Size of the mask (relative to the image size)
  "mask_rotation": 45.0, // Rotation angle of the mask (degrees)
  "mask_feather": 2, // Feathering effect of the mask edge
  "mask_invert": true, // Whether to invert the mask
  "mask_rect_width": 8, // Border width of the rectangular mask
  "mask_round_corner": 10 // Radius of rounded corners for the rectangular mask
}'

Responses

🟢200OK

application/json

Body

Example

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