剪映API服务
  1. 文本
剪映API服务
  • 一分钟,了解 剪映API服务!
  • 用户
    • 用户注册
      POST
    • 用户登录
      POST
  • 草稿
    • 创建草稿
      POST
    • 保存草稿
      POST
  • 文本
    • 获取文本入场动画
      GET
    • 获取文本出场动画
      GET
    • 获取文本循环动画
      GET
    • 获取字体
      GET
    • 获取花字
      GET
    • 添加文字(支持花字)
      POST
    • 添加字幕(支持花字)
      POST
    • 添加文字模板
      POST
  • 图片
    • 获取图片入场动画
      GET
    • 获取图片出场动画
      GET
    • 获取图片组合动画
      GET
    • 添加图片
      POST
  • 视频
    • 添加视频
      POST
  • 转场
    • 获取转场动画
      GET
  • 蒙版
    • 获取蒙版
      GET
  • 音频
    • 获取音频特效
      GET
    • 添加音频
      POST
  • 关键帧
    • 添加关键帧
  • 特效
    • 获取人物特效列表
    • 获取场景特效列表
    • 添加特效
  • 贴纸
    • 添加贴纸
  • 云渲染
    • 创建任务
    • 获取任务状态
    • 获取任务列表
  • 语音合成
    • 获取音色列表
    • 生成语音
  • 通用
    • 获取音视频时长
  1. 文本

添加字幕(支持花字)

POST
/text/add_subtitle
向草稿中添加字幕

请求参数

Authorization
API Key
在 header 添加参数
x-api-key
示例:
x-api-key: ********************
or
Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

🟢200失败
🟢200参数不正确
🔴500服务器异常
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://capcut.yyzc.net.cn/text/add_subtitle' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "srt": "1\\n00:00:00,000 --> 00:00:04,433\\n你333好,我是剪映草稿助手。", // 字幕内容或SRT文件URL(必填,支持直接传字幕文本或文件路径/URL)
    "draft_id": "your_draft_id_123", // 草稿ID(选填,用于指定要添加字幕的草稿)
    "time_offset": 0.0, // 字幕时间偏移量(秒,选填,默认0.0,可整体调整字幕显示时间)
    // 字体样式参数
    "font_size": 5.0, // 字体大小(选填,默认5.0)
    "font": "挥墨体",
    "bold": false, // 是否加粗(选填,默认false)
    "italic": false, // 是否斜体(选填,默认false)
    "underline": false, // 是否下划线(选填,默认false)
    "font_color": "#FFFFFF", // 字体颜色(选填,默认白色#FFFFFF,支持十六进制色值)
    "vertical": false, // 是否垂直显示(选填,默认false)
    "alpha": 1, // 字体透明度(选填,默认1,范围0-1,1为完全不透明)
    // 边框参数
    "border_alpha": 1.0, // 边框透明度(选填,默认1.0)
    "border_color": "#000000", // 边框颜色(选填,默认黑色#0a00000)
    "border_width": 0.0, // 边框宽度(选填,默认0.0)
    // 背景参数
    "background_color": "#000000", // 背景颜色(选填,默认黑色#000000)
    "background_style": 0, // 背景样式(选填,默认0,需与业务支持的样式枚举匹配,如0为无背景、1为矩形背景等)
    "background_alpha": 0.0, // 背景透明度(选填,默认0.0)
    // 图像调节参数
    "transform_x": 0.0, // X轴位置偏移(选填,默认0.0)
    "transform_y": -0.8, // Y轴位置偏移(选填,默认-0.8)
    "scale_x": 1.0, // X轴缩放比例(选填,默认1.0)
    "scale_y": 1.0, // Y轴缩放比例(选填,默认1.0)
    "rotation": 0.0, // 旋转角度(选填,默认0.0,单位为度)
    "track_name": "subtitle", // 轨道名称(选填,默认"subtitle")
    "width": 1080, // 画布宽度(选填,默认1080)
    "height": 1920 // 画布高度(选填,默认1920)
}'
响应示例响应示例
200 - 成功示例
{
    "code": 200,
    "message": "请求成功",
    "data": {
        "draft_id": "yyzc_capcut_1757382649_e406991f",
        "draft_url": "https://capcut.yyzc.net.cn/draft/downloader?draft_id=yyzc_capcut_1757382649_e406991f&is_capcut=0"
    },
    "timestamp": 1757382649149
}
修改于 2025-09-16 06:04:24
上一页
添加文字(支持花字)
下一页
添加文字模板
Built with