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. 返回文本樣式信息

相關接口

  • 添加字幕
  • 創建草稿
  • 保存草稿
  • 生成視頻

📚 項目資源
GitHub: 搜索capcut-mate即可找到