运营

POST /输入

总结 上传要按顺序使用的源文件。
URL. / api / v1 /输入
详细说明

使用此操作发送文件,以转录或字幕由Rev。

您必须指定文件的文件名和内容类型。成功完成后,Location响应头将包含媒体的URI,您可以在提交新订单时引用该媒体。

有三种方法可以转移媒体:

  • 直接上传它。为此,请将媒体数据作为帖子的主体发送。适当地设置Content-Type标题,并使用Content-Disposition标头指定媒体的文件名。
  • 使用MultiPart请求上传媒体。将Content-Type设置为“MultiPart / Form-Data”。MultiPart请求必须完全包含一个包含媒体数据的文件部分。文件名从本部分的Content-Disportaper标头的FileName组件中取出。要指定媒体的内容类型,请使用文件部分的内容类型标题,或者包含名称“content-type”的表单字段部分。
  • 我们让我们从您选择的服务器中检索数据。为此,请发送XML或JSON实体,如下面的“示例请求实体”部分所示。这将为我们提供URL和可选的媒体的文件名和内容类型。URL必须可公开访问

请求头
  • 授权- 包含客户端/用户API键
  • 内容类型- 如果媒体直接上传,这应该是媒体的内容类型。如果要检索介质,则这应该是应用程序/ XML或应用程序/ JSON。还支持的是多部分/表单数据,其中包含介质的单个部分。
  • 内容性格-如果媒体是直接上传的,那么这应该是“内容-配置:附件;文件名= " fname.ext”。输入媒体的文件名将取自此头文件。对于多部分或JSON/XML请求,不需要此头。
要求身体 媒体文件的二进制数据内容,或者具有包含媒体文件的二进制内容的一个部分的多部分主体,或者XML / JSON实体指定可以检索媒体的位置的XML / JSON实体。
响应 成功,201创建。
错误,400个不良请求。
响应头
  • 地点- URI标识新上传的媒体。此URI可用于在提交订单时识别此媒体。
响应体 成功,空。出错,将包含一个<错误/>实体,具有更多详细信息。
错误代码
  • 10001不支持的内容类型 - 如果我们的系统目前不支持媒体的内容类型。目前支持的内容类型是:

    - 音频/ AAC
    ——音频/ mp3
    ——音频/ mp4
    ——音频/ mp4a
    - 音频/ MP4A-LATM
    ——音频/ mpeg
    ——音频/ mpeg3
    - 音频/ ogg
    ——音频/ vnd.wave
    - 音频/ vorbis
    ——音频/ wav
    - 音频/ webm
    - 音频/ X-AAC
    - Audio / X-AIFC
    - 音频/ X-AIFF
    - 音频/ X-M4a
    ——音频/ x-mpeg-3
    - 音频/ X-Realaudio
    ——音频/ x-wav
    ——视频/ avi
    ——/ mp4视频
    ——视频/ mpeg
    - 视频/ msvideo
    - 视频/ ogg
    - 视频/ QuickTime
    - 视频/ webm
    ——视频/ x-flv
    - 视频/ X-M4V
    ——视频/ x-matroska
    - 视频/ X-MPEG
    - 视频/ X-MSVIDEO
    - 视频/ X-MS-WMV

  • 10002无法检索文件 - 如果我们无法从指定的位置检索文件。
  • 10003无效的Multipart请求 - 如果多级请求不包含一个文件部分,或者否则畸形。
  • 10004未指定的文件名-如果媒体的文件名没有显式指定且不能自动确定。
  • 10005未指定的URL - 如果未指定介质的URL。
注释转录或标题的样本请求

此JSON和XML选项卡显示示例请求实体,用于指定从中检索介质的位置。

multipart选项卡显示了一个示例multipart上传请求。

直接上传媒体内容时,请求实体应为媒体数据

{/ *可选,要检索的介质的内容类型。如果未指定,我们将尝试从服务器响应* /“content_type”:“视频/ mpeg”,/ *可选,介质的文件名。如果未指定,我们将从URL * /“filename”中确定它:“Video.mp4”,/ *必需,可以检索介质的URL。必须是公开的。只要有问题的网站有一个有效的证书* /“url”,https URL就可以了:“http://www.server.com/file/987834”}
< media_request > < !——可选,要检索的媒体的内容类型。如果没有指定,我们将尝试从服务器响应中确定它——> video/mpeg  video.mp4  http://www.server.com/file/987834 
-  aa--内容处理:形式数据;name =“示例”;filename =“Video.mp4”内容类型:视频/ MPEG文件数据--AA--