VideoEditorSaveSubtitle - 实时保存字幕内容--机器翻译-火山引擎

文档中心

机器翻译

视频工具

VideoEditorSaveSubtitle - 实时保存字幕内容

修改字幕内容，可修改译文、原文、字幕样式、配音内容，修改后字幕内容会即时生效（即压制视频会使用修改后的字幕内容）。注意：后续会迭代成调用提交校对接口后字幕才会生效，建议提交校对后再进行压制视频等操作

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	VideoEditorSaveSubtitle	要执行的操作，取值：VideoEditorSaveSubtitle。
Version	String	是	2021-05-21	API的版本，取值：2021-05-21。
subs	Array of Object	是	[ { "startTime": "2480", "endTime": "7160", "segmentId": "c1821edc-fa67-484d", "source": { "text": "对对对" }, "target": { "text": "Can't we do something new? can you 3" }, "segmentSettings": { "autoRefillSetting": 0 }, "assistTextType": 0, "assistText": "", "sourceStyle": "", "targetStyle": "", "effectType": 0, "sourceLqaData": "", "targetLqaData": "", "voiceTosUrl": "https://sf1-cdn-tos.huoshanstatic.com/obj/ies.fe.starling/seg_67596952066_1868041847_2_1774329390_c75a99d7.mp3?duration=8933&end_time=7591&index=3&match_score=95&speed_factor=0.98&start_time=5468&total=5", "relatedSegmentId": "" } ]	字幕信息
subtaskId	String	是	"32403403778"	子任务id

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
data	Object	{ "ResponseMetadata": { "Action": "VideoEditorSaveSubtitle", "Version": "2021-05-21", "Service": "i18n_openapi", "Region": "cn-north-1", "RequestId": "20260401120117F" }, "Result": { "data": { "baseResp": { "statusMessage": "success", "statusCode": 0 }, "sub": [ { "segmentId": "c1821edc-fa67", "operator": "67300624", "startTime": "2480", "endTime": "7160", "source": { "text": "对对对" }, "target": { "text": "Can't we do something new? can you 3" }, "segmentSettings": { "autoRefillSetting": 0 }, "assistTextType": 0, "assistText": "", "sourceStyle": "", "targetStyle": "", "effectType": 0, "voiceTosUrl": "https://sf1-cdn-tos.huoshanstatic.com/obj/ies.fe.starling/seg_67596952066_1868041847_2_1774329390_c75a99d7.mp3?duration=8933&end_time=7591&index=3&match_score=95&speed_factor=0.98&start_time=5468&total=5", "relatedSegmentId": "" } ] } }, "data": { "baseResp": { "statusMessage": "success", "statusCode": 0 }, "sub": [ { "segmentId": "c1821edc-fa67", "operator": "67300624", "startTime": "2480", "endTime": "7160", "source": { "text": "对对对" }, "target": { "text": "Can't we do something new? can you 3" }, "segmentSettings": { "autoRefillSetting": 0 }, "assistTextType": 0, "assistText": "", "sourceStyle": "", "targetStyle": "", "effectType": 0, "voiceTosUrl": "https://sf1-cdn-tos.huoshanstatic.com/obj/ies.fe.starling/seg_67596952066_1868041847_2_1774329390_c75a99d7.mp3?duration=8933&end_time=7591&index=3&match_score=95&speed_factor=0.98&start_time=5468&total=5", "relatedSegmentId": "" } ] } }	保存结果

请求示例

POST /openapi/video/editor/saveSubtitle
HOST：open.volcengineapi.com
ServiceName：i18n_console
{
  "subtaskId": 15557560,
  "subs": [
    {
      "segmentId": "seg_1",
      "startTime": 0,
      "endTime": 1800,
      "source": { "text": "hello" },
      "target": { "text": "你好" },
      "effectType": 0,
      "voiceTosUrl": "",
      "speakerId": 1001,
      "emotionTag": "开心"
    }
  ]
}

返回示例

{
  "data": {
    "baseResp": {
      "statusCode": 0,
      "statusMessage": "success"
    },
    "sub": [
      {
        "segmentId": "seg_1",
        "operator": "demo_user",
        "startTime": 0,
        "endTime": 1800,
        "source": {
          "text": "hello",
          "style": ""
        },
        "target": {
          "text": "你好",
          "style": ""
        },
        "status": 0,
        "segmentSettings": {
          "autoRefillSetting": 0
        },
        "assistTextType": 0,
        "assistText": "",
        "createTime": 1710000000000,
        "updateTime": 1710000000000,
        "confirmTime": 1710000000000,
        "sourceStyle": "",
        "targetStyle": "",
        "effectType": 0,
        "sourceLqaData": "",
        "targetLqaData": "",
        "id": 1,
        "voiceTosUrl": "",
        "speakerId": 1001,
        "aiVoiceId": 2001,
        "relatedSegmentId": "seg_0",
        "extra": "{}"
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	1001	Server Error	服务内部错误

补充说明

字幕样式说明

fontSize: 表示设置字幕的字体大小，范围从 11 - 72，取整数即可；横屏推荐20，竖屏推荐11；
fontFamily: 是字体族，取值可见下表的value；
x: 字幕水平坐标。-1.0 : 画面最左边缘; 0.0 : 画面水平中心; 1.0 : 画面最右边缘；
y: 字幕垂直坐标。-1.0 : 画面最下边缘; 0.0 : 画面垂直中心; 1.0 : 画面最上边缘；
alignment：文本对齐方式。0代表左对齐，1代表居中对齐，2代表右对齐，3代表上对齐，4代表下对齐；
show: 是给前端译员端用的字段来控制在页面上是否展示的，可以直接传true；

字体族取值范围

字体名称	字体 value
方正兰亭圆简体	fz_lantingyuan_jianti
方正兰亭中黑简体	fz_lantingzhonghei_jianti
方正颜宋简体	fz_yansong_jianti
方正新楷体简体	fz_xinkaiti_jianti
ArialUnicodeMS	arial
聚珍体	9893366
楷書 MCBK1	20404082
妙黑体	9893360
糯米团	1053145
庞门正道标题体	20379275
思源中宋	643578
细体	349520
新青年体	349308
Amita-Bold	14444020
Eczar-SemiBold	13897166
Harmattan-Regular	14035806
Kurale-Regular	14449082
Martel Sans-Black	13891582
Martel Sans-Bold	13891540
Martel Sans-ExtraBold	13891048
Martel Sans-Ext

最近更新时间：2026.05.12 16:20:44

这个页面对您有帮助吗？

有用

无用

机器翻译

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

补充说明 #

字幕样式说明 #