操作

GET /附件/ {ID} /内容

总结 获取原始数据带指定id的附件
URL / API / V1 /附件/ {ID} /内容
详细描述

下载附件的内容。使用此方法可下载完成的输出文件(文本或字幕,取决于您所下的订单类型)或订单的源文件。

在关闭附件的所有编辑器会话至少两分钟后,此端点将检索附件的最新版本,包括编辑。

对于输出文件附件,您可以请求以特定的表示形式(文件格式)获取内容,要么通过Accept HTTP头,要么通过将扩展附加到URL的末尾。

如果您选择在订单中请求时间戳,您可以从您的成绩单中检索行内间隔时间戳(例如,每30秒)或每个单词时间戳。每个字的时间戳只适用于JSON格式,所有其他输出格式都使用间隔时间戳。

烧屏字幕视频附件(附件种类= burnedin)是特殊的。在接受头被忽略,他们被当做返回没有转换,始终与视频/ MP4内容类型。他们也没有包括任何客户的编辑(如果你愿意的话,你可能会产生烧屏与客户字幕编辑器内反映的客户编辑视频)。

下面的表示是支持人类的成绩单和自动化的成绩单:

媒体类型 延期 描述
应用程序/ vnd.openxmlformats-officedocument.wordprocessingml.document 。docx Open Office XML (Microsoft Word 2007+使用的格式)
应用/ PDF. .PDF Adobe PDF
文字/平原 . txt 纯文本,去掉控制字符
文本/无格式;格式= YouTube的转录物 N / A - 必须使用Accept报头 纯文本,使用YouTube的成绩单格式。更多信息。
application / json + rev-transcript 以.json JSON输出。参见下面的JSON输出示例。
应用程序/ x-subrip
(自动转录只)
.srt 见下面的标题格式表。
文本/国立
(自动转录只)
.vtt 见下面的标题格式表。
{ “扬声器”:[{ “ID”:1, “名称”: “受访者”},{ “ID”:2 “名称”: “访”}],/ *独白(转录语音)。每个独白对应于文字从一个扬声器运行。* / “独白”:[{ “ID”:1, “扬声器”:1,/ *者ID,与上述相同* / “SPEAKER_NAME” 为宣称: “受访者”,/ *扬声器名称,与上述相同声明* // *独白的元素。每个元素都是文本(转录语音)或标签(注释),诸如听不到的或串扰。文本元素可能会或可能不会包含时间戳。标签元素需要一个时间戳。* /“元素”:[{/ *文本元素,没有时间戳* /“类型”:“文本”,/ *的文本元素,值包含文本* /“值”:“我从来没有来过这里已经”},{/ *标签元件* / “类型”: “标签”,/ *对于标记元素,值包含注释类型* / “值”: “无声”,/ *时间戳格式为HH:MM:SSS,FFF其中FFF表示毫秒* /“时间戳”:“00:00:07000”},/ *文本元素,每字时间戳空白和标点符号不时间戳* / {“类型”:“文本”,“值”: " " }, { "type": "text", "value": "so", "timestamp": "00:00:20,000", "end_timestamp": "00:00:20,138" }, { "type": "text", "value": " " }, { "type": "text", "value": "this", "timestamp": "00:00:20,222", "end_timestamp": "00:00:20,566" } ] } ] }

以下陈述都支持字幕:

媒体类型 延期 描述
应用程序/ x-subrip .srt SubRip是SubRip程序最先使用的一种简单的字幕文本格式。更多信息。
文/ X-SCC .scc 编剧隐藏式字幕,旧的,但流行的格式,被许多视频创作工具,如Adobe首映使用。更多信息。
文/ X-MCC .mcc MacCaption (.mcc)格式用于高清广播电视。
应用/ TTML + xml的 .ttml 计时文本标记语言,一种W3C标准,用于指定与视频一起显示的计时文本。更多信息。
应用程序/ x-quicktime-timedtext .qt.txt Quicktime Timed Text是苹果Quicktime Authoring软件支持的专用文本格式,用于指定定时文本。更多信息。
文本/ x-rev-transcript . txt 纯文本格式
文本/国立 .vtt 该WebVTT插入(网络视频文本轨道)格式的目的是用于标记外部文本轨道资源。为WebVTT插入文件的主要用途是字幕或对白字幕的视频内容。更多信息。
应用/ TTAF + xml的 .dfxp 分发格式交换概要用于在现有的用于字幕和字幕功能的分发内容格式之间进行代码转换或交换定时文本信息。更多信息。
应用程序/ x-cheetah-cap 。帽 离线猎豹俘获器的文件格式
文/ X-STL .stl Spruce Subtitle File,一种简单的字幕文本格式,最初由DVD Studio Pro使用。更多信息。
文本/ vnd.avid-ds . txt Avid DS Subtitle File: Avid DS软件的字幕文件格式
文/ vnd.avid-DVD . txt Avid DVD字幕文件,是Avid DVD软件的字幕文件格式
文本/ x-facebook-srt .srt 标准的SubRip文件与Facebook文件命名约定。更多信息。

如果不支持输出文件所要求的表示,那么406不可接受的状态代码将被退回。与Accept报头,则可以指定多个可接受的表示(如在所描述的接受头HTTP规范),以及最佳匹配将被退回。

如果您没有通过Accept头或URL扩展名指定所需的表示形式,那么输出文件内容将以默认格式返回。对于文本,这将是一个JSON输出。对于标题,这将是SubRip(.SRT)文件。

对于源媒体附件,我们目前不支持多个表示。他们总是在他们所上传的原始格式返回。如果指定Accept头或扩展不原始格式相匹配,一个406不可接受的状态代码将被退回。

对于文本,如果您以纯文本表示请求附件(使用“Accept: text/plain”头或“.txt”URL扩展名),还可以使用Accept- charset HTTP头请求特定字符编码。支持以下编码:

字符集编码 描述
utf - 8 UTF-8编码。不包括字节顺序标记。
UTF-16 utf - 16编码。注意,这将导致一个二进制文件——这不太可能是您想要的。
ISO-8859.1. 通常被称为西欧(ISO),它由ASCII字符、一组十六进制80-9F范围的控制字符,加上一个“拉丁扩展”字符块,该字符块包含十六进制A0-FF范围的通用符号和变音符化字符。00-FF范围之外的字符将被映射到与其最接近的对等字符或被“?”替换。
这个字符集的全部细节在这里:https://en.wikipedia.org/wiki/ISO/IEC_8859-1
windows - 1252 Windows代码页1252,或西欧(Windows)中。类似于ISO-8859-1,但使用的字符以十六进制80-9F范围内显示的字符,如智能引号,而不是控制字符。
这个字符集的全部细节在这里:https://en.wikipedia.org/wiki/Windows-1252
US-ASCII US ASCII -这完全由十六进制00-7F范围的ASCII字符组成,包括数字、字母a-z和a-z、标点符号和一些控制字符。00-FF范围之外的字符通常会被省略,除了被变音符化的字符会被它们的基本拉丁字符替换(例如À被A替换)。
这个字符集的全部细节在这里:https://en.wikipedia.org/wiki/ASCII

如果您没有通过Accept-Charset头指定所需的字符编码,那么将使用UTF-8编码。如果请求的不是纯文本表示,那么Accept-Charset头将被忽略。

请求参数
  • Id -要检索的附件的Id
请求头
  • 授权——包含客户端/用户API密钥
  • 接受 - 可选的,指定附件作为媒体类型的所需的格式。
  • 接收字符集 - 可选的,指定附件所需的字符集编码,如果请求纯文本表示。
响应 成功时,200 OK。
如果没有找到给定id的附件,404没有找到
如果附件中没有要求的陈述,406不可接受
响应头
  • 内容类型 - 内容类型的附件
响应体 成功后,附件内容的原始数据按照要求的格式
错误代码 没有一个