add_subtitle

POST

/add_subtitle

Add subtitles to the specified draft. This function has the additional capability of directly adding subtitles in SRT format compared to the add_text method, but it does not support animations.

Request

Header Params

Body Params application/json

Example

{
  "srt": "1\\n00:00:00,000 --> 00:00:04,433\\n你333好，我是孙观楠开发的剪映草稿助手。", // Subtitle content in SRT format, or srt file link
  "draft_id": "your_draft_id_123", // The ID of the draft to which subtitles will be added
  "time_offset": 0, // Time offset (in seconds)
  "font_size": 5, // Font size
  "font": "Anson", // Font name (e.g., Anson)
  "bold": false, // Whether to bold the text
  "italic": false, // Whether to italicize the text
  "underline": false, // Whether to underline the text
  "font_color": "#FFFFFF", // Font color (in HEX format)
  "vertical": false, // Whether the text is arranged vertically
  "alpha": 1, // Font transparency (0-1)
  "border_alpha": 1, // Text border transparency (0-1)
  "border_color": "#000000", // Text border color (in HEX format)
  "border_width": 0, // Text border width
  "background_color": "#000000", // Text background color (in HEX format)
  "background_style": 0, // Text background style (0-No background, 1-Rectangular background, 2-Rounded rectangular background)
  "background_alpha": 0, // Text background transparency (0-1)
  "transform_x": 0, // Horizontal position offset (proportion relative to video width)
  "transform_y": -0.8, // Vertical position offset (proportion relative to video height)
  "scale_x": 1, // Horizontal scaling ratio
  "scale_y": 1, // Vertical scaling ratio
  "rotation": 0, // Rotation angle (in degrees)
  "track_name": "subtitle", // Subtitle track name(e.g., subtitle)
  "width": 1080, // Video width (in pixels)
  "height": 1920 // Video height (in pixels)
}

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_subtitle' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
  "srt": "1\\n00:00:00,000 --> 00:00:04,433\\n你333好，我是孙观楠开发的剪映草稿助手。", // Subtitle content in SRT format, or srt file link
  "draft_id": "your_draft_id_123", // The ID of the draft to which subtitles will be added
  "time_offset": 0, // Time offset (in seconds)
  "font_size": 5, // Font size
  "font": "Anson", // Font name (e.g., Anson)
  "bold": false, // Whether to bold the text
  "italic": false, // Whether to italicize the text
  "underline": false, // Whether to underline the text
  "font_color": "#FFFFFF", // Font color (in HEX format)
  "vertical": false, // Whether the text is arranged vertically
  "alpha": 1, // Font transparency (0-1)
  "border_alpha": 1, // Text border transparency (0-1)
  "border_color": "#000000", // Text border color (in HEX format)
  "border_width": 0, // Text border width
  "background_color": "#000000", // Text background color (in HEX format)
  "background_style": 0, // Text background style (0-No background, 1-Rectangular background, 2-Rounded rectangular background)
  "background_alpha": 0, // Text background transparency (0-1)
  "transform_x": 0, // Horizontal position offset (proportion relative to video width)
  "transform_y": -0.8, // Vertical position offset (proportion relative to video height)
  "scale_x": 1, // Horizontal scaling ratio
  "scale_y": 1, // Vertical scaling ratio
  "rotation": 0, // Rotation angle (in degrees)
  "track_name": "subtitle", // Subtitle track name(e.g., subtitle)
  "width": 1080, // Video width (in pixels)
  "height": 1920 // Video height (in pixels)
}'

Responses

🟢200OK

application/json

Body

Example

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

Modified at 2025-08-07 09:28:50

add_text

search_artist