生成字幕 API

接口描述

根据音频、视频中的语音,自动生成字幕;企业会员可定制。

请求说明

  • 请求 URL:https://api.guangfan.tech/v1/get-subtitle
  • 请求方式:POST
  • 返回类型:JSON 数据
  • 输入参数:

1、请求参数(Header)

参数参数类型描述
content-typestringapplication/json
api-keystring您的专属 API 密钥

2、请求参数(Body)

{
  "language": "chinese", // 必填,音视频语种,不同语言对应的编码可以参考下文。
  "fileUrl": "https://abc.com/42769.mp4", // 必填,目标音视频链接,必须是公网可访问的音视频文件。
  "notifyUrl": "https://abc.com/notify", // 必填,字幕识别结果的回调地址(POST 方式)。
  "resultType": "srt", // 可选,返回的字幕类型,默认"srt"。"srt": 字幕文件;"json": json数据。
  "wordsLimit": 20, // 可选,单行字幕的字数上限,仅限语言为中文时使用(范围6-40)。
}
音视频语言编码:
编码语言
chinese中文
guangdongChinese粤语
weiyuChinese维吾尔语
english英语
japanese日语
korean韩语
russian俄语
france法语
spanish西班牙语
arabic阿拉伯语
indonesia印度尼西亚语

3、返回数据

{
  code: 0, // 结果状态码:0 表示成功;其他请参考 “错误码说明” 页面
  data: 'uneUH9mnpwH163248854', // 任务 ID
  message: '', // 结果提示信息
}

4、回调返回数据(任务完成后,发送到 notifyUrl 的数据)

{
  taskId: 'uneUH9mnpwH163248854', // 任务 ID
  code: 0, // 结果状态码:0 表示成功;其他请参考 “错误码说明” 页面
  data: 'https://abc.com/987654.srt', // 结果字幕文件链接,或者 JSON 数据
  message: '', // 结果提示信息
}

价格说明

  • API 任务和本地任务共享时长,时长可以在定价页面购买;
  • 生成字幕 API 任务消耗时长为: 视频时长(秒)x2,低于1分钟的视频时长计为1分钟。
  • 账户剩余时长可以在账号页面查看。
  • 任务结果缓存一周。

常见问题

  • Q:输入的音视频格式有什么要求?
  • A:支持几乎所有音频、视频格式,包含语音即可。
  • Q:输入的音视频大小和时长有限制吗?
  • A:文件大小无限制,时长最长 5 个小时。