第二步:下订单

现在您已成功使用沙箱键可以放置您的第一个请求,我们已准备好开始下订单。

在所有Rev服务线上的下订单的过程是相同的 - 无论您是下订单都无关紧要转录标题或者外国字幕

您可以使用其中之一来指定服务行caption_options或者transcription_options在请求正文中。在下面的示例中,我们将设置标题订单。

下面我们将介绍不同的下单方式:

  1. 使用公共URL或URI提交订单
  2. 使用本地文件提交订单

1.使用公共URL或URI提交订单

嵌入在网页上的媒体(YouTube, Vimeo等)可以直接提交到POST /订单使用external_link

在下面的示例中,我们使用YouTube URL创建标题顺序。我们还指定了要为SubRip文件格式优化的顺序output_file_formats.请注意:指定output_file_formats与请求这些格式进行下载是不一样的—稍后我们将在检索完成的文件步骤中介绍这一点。

curl - i - x发布https://api-sandbox.rev.com/api/v1/orders \ \ - h的授权:牧师[ClientApiKey]: [UserAPIKey] \ - h的application / json内容类型:\ - d '{“caption_options”:{“输入”:[{“external_link”:“https://www.youtube.com/watch?v=E0arJC0CJ7k”}],“output_file_formats”:[" SubRip "]}}”

2.将本地文件提交给发布/输入

提交本地媒体文件有两个步骤。首先使用POST /输入将文件发送给Rev。

在下面的例子中,替换[INSERT FILE PATH HERE],保留'@'符号。如果你需要一个小的样本视频,你可以下载一个这里

curl -i -X POST \ https://api-sandbox.rev.com/api/v1/inputs \ -H 'Authorization: Rev [ClientApiKey]:[UserAPIKey]' \ -H 'Content-Type: video/mp4' \ -H 'content-disposition:附件;filename="filename.mp4"' \——data-binary '@[INSERT FILE PATH HERE]'

提交到发布/输入后,您应该收到与下面类似的响应。

http / 1.1 201创建了Cache-Control: no-cache Content-Length: 0 Date: Fri, 18 May 2018 17:23:45 GMT Expires: -1位置:URN:Rev:InputMedia:Rxvwbg9hzhmvmjaxoc0wns0xni8yy2uxywfmns04zasdfq4nzmtogrmmc05y2i2zdkwn2vinzivbgvnb3zpzgvvlm1wna服务器:Microsoft-IIS/10.0 X-MiniProfiler-Ids: ["00109bf4-bcf5-41af-92e5-0150703b8a4f"]净

上述响应的相关部分用粗体表示。

  • 201年创建告诉我们我们将文件发布到Rev成功。
  • Location给出了我们刚刚发布给Rev的文件的URI。

现在我们已经为第二步做好了准备——获取URI并将其与POST /orders一起使用。

下面的命令放置一个标题顺序,文件输出类型为.srt。Rev通常(但不总是)能够自动检测文件的长度。在这个例子中,我们添加了Video_length_seconds.到了请求的身体。

curl -i -X POST \ https://api-sandbox.rev.com/api/v1/orders \ -H 'Authorization: Rev [ClientApiKey]:[UserAPIKey]' \ -H 'Content-Type: application/json' \ -d '{"caption_options": {"inputs": [{"video_length_seconds": 6, "uri":"urn:rev:inputmedia:RXVwbG9hZHMvMjAxOC0wNS0xNi8yY2UxYWFmNS04ZasdfQ4NzMtOGRmMC05Y2I2ZDkwN2ViNzIvbGVnb3ZpZGVvLm1wNA"}], "output_file_formats": ["SubRip"]}}'

收到Rev的回复

无论您提交到REV的哪种类型的媒体,所有订单都将收到类似于下面的HTTP响应:

Cache-Control:No-Cache Content-Length:0日期:星期三,2018年5月16日19:09:05 GMT到期:-1地点:https://api-sandbox.rev.com/api/v1/orders/CP0938707965Pragma: no-cache Server: Microsoft-IIS/10.0 X-MiniProfiler-Ids: ["f38e8e42-e513-4c96-9bd7-a17f412593ad"]净

地点响应包含在rev中创建的订单的URL。URL的最后一部分CP0948053481为订单号。

恭喜!您已经使用Rev API下了第一笔订单。

遇到麻烦?电子邮件apisupport@rev.com.我们的一个工程师会回答。