Skip to content

[v8.1.12] ✨ add_captions 支持自定义描边不透明度与宽度

Choose a tag to compare

@Hommy-master Hommy-master released this 30 Oct 03:56
· 19 commits to main since this release

🎯 本次更新

  • add_captions 接口新增描边不透明度与描边宽度参数,解决此前两者在代码中写死、调用方无法调整的问题。

✨ 新增功能

  • 新增接口级参数 border_alpha,取值范围 0.0 到 1.0,默认 1.0
  • 新增接口级参数 border_width,取值范围 0 到 100,与剪映 UI 一致,默认 40
  • 普通字幕描边与关键词描边都会应用这两个参数

🔧 行为说明

  • 仅在提供描边颜色时生效,包括 border_color 与 keyword_border_color
  • 宽度会在服务内部换算为草稿值,默认 40 对应此前的 0.08
  • 不传新参数时输出与旧版本一致,完全向后兼容
  • 关键词描边暂不支持单独设置宽度或不透明度

📚 文档更新

  • 中英文 add_captions 文档补充参数表与描边说明
  • 完整参数示例、cURL 示例、参数速查表同步更新
  • 改动已同步至外部文档站点

✅ 测试

  • 新增描边参数专项测试,覆盖默认值兼容、自定义取值、关键词高亮与关键词阴影两条路径、无描边颜色场景、取值范围校验
  • 相关字幕测试全部通过

⚠️ 注意事项

  • openapi.yaml 未修改,需要手动补充 border_alpha 与 border_width 两个字段并上传至 API 平台