【剪映小助手】为文本创建富文本样式

简介: 为文本创建富文本样式,支持关键词高亮、颜色设置、字体大小调整等功能。该接口可以将普通文本转换为包含样式信息的富文本格式,实现关键词突出显示、多样化的文本展示效果。

ADD_TEXT_STYLE API 接口文档

接口信息

POST /openapi/capcut-mate/v1/add_text_style

功能描述

为文本创建富文本样式,支持关键词高亮、颜色设置、字体大小调整等功能。该接口可以将普通文本转换为包含样式信息的富文本格式,实现关键词突出显示、多样化的文本展示效果。

更多文档

📖 更多详细文档和教程请访问:https://docs.jcaigc.cn

请求参数

{
   
  "text": "五个快乐到死的顶级思维",
  "keyword": "快乐|顶级思维",
  "font_size": 12,
  "keyword_color": "#ff7100",
  "keyword_font_size": 15
}

参数说明

参数名 类型 必填 默认值 说明
text string ✅ - 要处理的文本内容
keyword string ✅ - 关键词,多个用 \ 分隔
font_size number ❌ 12 普通文本的字体大小
keyword_color string ❌ "#ff7100" 关键词文本颜色(十六进制)
keyword_font_size number ❌ 15 关键词字体大小

参数详解

文本参数

  • text: 需要进行样式处理的原始文本内容
    • 示例:"五个快乐到死的顶级思维"

关键词参数

  • keyword: 需要高亮显示的关键词,支持多个关键词用竖线(|)分隔
    • 示例:"快乐|顶级思维"
    • 注意:系统会按关键词长度优先匹配,避免短关键词覆盖长关键词

字体大小参数

  • font_size: 普通文本(非关键词)的字体大小

    • 默认值:12
    • 建议范围:8-72
  • keyword_font_size: 关键词的字体大小

    • 默认值:15
    • 建议范围:8-72

颜色参数

  • keyword_color: 关键词的文本颜色,使用十六进制格式
    • 默认值:"#ff7100" (橙色)
    • 格式:#RRGGBB
    • 示例:"#ff0000" (红色), "#00ff00" (绿色), "#0000ff" (蓝色)

响应格式

成功响应 (200)

{
   
  "text_style": "{\"styles\":[{\"fill\":{\"content\":{\"solid\":{\"color\":[1,1,1]}}},\"range\":[0,2],\"size\":12,\"font\":{\"id\":\"\",\"path\":\"\"}},{\"fill\":{\"content\":{\"solid\":{\"color\":[1,0.44313725490196076,0]}}},\"range\":[2,4],\"size\":15,\"font\":{\"id\":\"\",\"path\":\"\"},\"useLetterColor\":true},{\"fill\":{\"content\":{\"solid\":{\"color\":[1,1,1]}}},\"range\":[4,7],\"size\":12,\"font\":{\"id\":\"\",\"path\":\"\"}},{\"fill\":{\"content\":{\"solid\":{\"color\":[1,0.44313725490196076,0]}}},\"range\":[7,11],\"size\":15,\"font\":{\"id\":\"\",\"path\":\"\"},\"useLetterColor\":true}],\"text\":\"五个快乐到死的顶级思维\"}"
}

响应字段说明

字段名 类型 说明
text_style string 文本样式JSON字符串,包含styles数组和text字段

错误响应 (4xx/5xx)

{
   
  "code": 2026,
  "message": "无效的文本样式信息,请检查文本或关键词参数"
}

使用示例

cURL 示例

1. 基本文本样式创建

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/add_text_style \
  -H "Content-Type: application/json" \
  -d '{
    "text": "五个快乐到死的顶级思维",
    "keyword": "快乐|顶级思维"
  }'

2. 自定义字体大小

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/add_text_style \
  -H "Content-Type: application/json" \
  -d '{
    "text": "五个快乐到死的顶级思维",
    "keyword": "快乐|顶级思维",
    "font_size": 14,
    "keyword_font_size": 18
  }'

3. 自定义关键词颜色

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/add_text_style \
  -H "Content-Type: application/json" \
  -d '{
    "text": "五个快乐到死的顶级思维",
    "keyword": "快乐|顶级思维",
    "keyword_color": "#ff0000"
  }'

错误码说明

错误码 错误信息 说明 解决方案
2026 无效的文本样式信息,请检查文本或关键词参数 文本或关键词参数格式错误或值无效 检查text和keyword参数是否符合要求
2027 文本样式创建失败 创建文本样式过程中发生错误 联系技术支持

注意事项

  1. 关键词匹配: 关键词按长度优先匹配,长关键词优先于短关键词
  2. 颜色格式: 使用标准十六进制颜色格式 #RRGGBB
  3. 字体大小: 建议在8-72范围内
  4. 关键词分隔: 多个关键词使用竖线 | 分隔
  5. 大小写敏感: 关键词匹配区分大小写

工作流程

  1. 验证必填参数(text, keyword)
  2. 解析关键词字符串
  3. 在文本中查找关键词位置
  4. 转换颜色值为RGB格式
  5. 生成文本样式数组
  6. 构建响应对象
  7. 返回文本样式信息

相关接口


相关文章
|
7月前
|
Linux API Docker
【开源剪映小助手】配置与部署
本文档面向运维与开发人员,系统介绍 capcut-mate 的配置、部署与运维实践。涵盖Python+FastAPI架构、跨平台(Win/Linux)支持、Docker容器化、腾讯云COS集成、CI/CD自动化及性能优化等核心内容,助力快速稳定上线。(239字)
|
7月前
|
JSON 前端开发 中间件
【开源剪映小助手】API 接口文档
CapCut Mate 是基于 FastAPI 构建的剪映自动化 API,提供草稿管理、媒体添加、特效/字幕/贴纸应用、时间线计算及云端渲染等 RESTful 接口,遵循 OpenAPI 规范,支持中英文双语文档与完整错误处理。(239字)
2628 0
|
7月前
|
缓存 监控 API
【开源剪映小助手】媒体处理功能
CapCut Mate是基于剪映的专业视频编辑辅助工具,提供视频、音频、图片、字幕的智能添加、处理与时间线管理。采用FastAPI架构,集成UI自动化控制、多级缓存及异步任务调度,支持微秒级精度编排与完善错误恢复,兼顾高性能与高可用性。(239字)
|
7月前
|
存储 缓存 数据库
【开源剪映小助手】核心功能详解
CapCut Mate 是基于 Python 的剪映自动化工具,通过 FastAPI 提供 RESTful 接口,支持草稿管理、媒体处理、效果编辑与视频生成全流程自动化。采用分层模块化架构,具备双文件模板兼容、智能缓存、异步渲染及完善故障排查能力。(239字)
|
7月前
|
缓存 API UED
【开源剪映小助手】核心功能之草稿管理系统
剪映草稿管理系统基于FastAPI与Electron构建,支持草稿全生命周期管理、default2模板迁移、双文件(draft_content.json/draft_info.json)同步及跨平台目录扫描(robocopy/rsync),自动触发剪映/Premiere草稿发现,无需重启,提升创作效率。(239字)
|
8月前
|
JSON JavaScript 安全
【开源剪映小助手-客户端】Node.js 集成
本文系统介绍 capcut-mate 桌面端 Node.js 与 Electron 的安全集成方案:采用“主进程+预加载桥接+渲染进程”三层架构,通过 contextBridge 有限暴露 API,实现下载管理、文件操作、日志记录及新增的跨平台目录扫描(triggerDirectoryScan)功能,助力 Adobe Premiere Pro 自动识别新草稿。
|
11月前
|
存储 缓存 API
【剪映小助手】向现有草稿中添加贴纸
向现有草稿中添加贴纸。该接口用于在指定的时间段内添加贴纸素材到剪映草稿中,支持贴纸的缩放和位置调整。贴纸可以用于增强视频的视觉效果,如表情、装饰、文字等。
|
11月前
|
编解码 缓存 API
【剪映小助手】在现有草稿中添加多种类型的素材内容
在现有草稿中添加多种类型的素材内容,包括音频、视频、图片和文字。该接口可以一次性向草稿添加多种媒体素材,自动处理素材的时长、尺寸等属性,并智能管理不同类型的媒体轨道。是视频创作的核心接口之一。
1109 0
|
8月前
|
监控 中间件 API
【剪映小助手】故障排除与常见问题
本指南面向capcut-mate用户与运维人员,系统解析安装、部署、运行及排障全流程。涵盖剪映自动化失败、API异常、Docker问题、性能优化与兼容性处理,提供日志分析技巧与精准路径定位,助你高效自助排障。(239字)
|
11月前
|
存储 JSON 缓存
【剪映小助手】向现有草稿中批量添加字幕
向现有草稿中批量添加字幕。该接口用于在指定的时间段内添加字幕到剪映草稿中,支持丰富的字幕样式设置,包括文本颜色、边框颜色、对齐方式、透明度、字体、字体大小、字间距、行间距、缩放和位置调整等。