查询字幕预设

查询视频字幕预设，取得可直接传入 subtitle_style 的完整样式对象。

v1查询接口 Bearer 鉴权

POSThttps://popto.cn/api/open/v1/subtitle/preset_style/list

鉴权与请求头

在 API 密钥管理 ↗ 创建密钥，每次请求在 HTTP Header 中携带。

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typeapplication/json必填

请求参数 Body · JSON

无需业务参数，发送空 JSON 对象 {} 即可。

返回值与结构

成功时 ret = 0，业务数据位于 data.ent。以下为 data.ent 中的字段。

stylesobject[]

可用字幕样式。

查看数组元素字段 13

idstring

字幕样式 ID。

namestring

样式名称。

font_namestring

字体名称，从字体列表选择。

font_urlstring

可选字体文件 URL。

font_sizenumber

字体大小。

boldboolean

是否加粗。

italicboolean

是否斜体。

text_colorstring

文字颜色。

background_colorstring

背景颜色。

stroke_colorstring

描边颜色。

stroke_widthnumber

描边宽度。

opacitynumber

透明度。

letter_spacingnumber

字间距。

调用说明

样式来自服务端配置；可保留完整对象修改后传入视频生成接口，不能只提交样式 ID。

处理业务响应

HTTP 200 仍可能返回业务错误，请同时检查 ret、code 和 msg。查看响应与错误码

请求示例Request

bash

curl --request POST \
  'https://popto.cn/api/open/v1/subtitle/preset_style/list' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'

成功响应200 OK

json

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "styles": [
        {
          "id": "subtitle_example",
          "name": "白字黑边",
          "font_name": "zh-hans",
          "font_size": 65,
          "bold": false,
          "italic": false,
          "text_color": "#FFFFFF",
          "background_color": "#00000000",
          "stroke_color": "#000000",
          "stroke_width": 2,
          "opacity": 1,
          "letter_spacing": 0
        }
      ]
    }
  }
}

示例内容用于说明结构。任务 ID、积分和执行结果以实际响应为准。