第二步:下订单
现在您已成功使用沙箱键可以放置您的第一个请求,我们已准备好开始下订单。
在所有Rev服务线上的下订单的过程是相同的 - 无论您是下订单都无关紧要转录,标题或者外国字幕.
您可以使用其中之一来指定服务行caption_options
或者transcription_options
在请求正文中。在下面的示例中,我们将设置标题订单。
下面我们将介绍不同的下单方式:
- 使用公共URL或URI提交订单
- 使用本地文件提交订单
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 "]}}”
var https =要求('https');var post_data = json.stringify({caption_options:{informs:[{hyperence_link:'https://www.youtube.com/watch?v=e0arjc0cj7k'}],output_file_formats:['子填充']}});var选项= {host:'api-sandbox.rev.com',路径:'/ api / v1 / domens',方法:'post',标题:{'授权':'rev [clientapikey]:[userapikey]','content-type':'application / json'}};var post_req = https.request(选项,(resp)=> {console.log('状态代码:',resp.statuscode); console.log('标题:',resp.headers);});post_req.write(post_data);post_req.end();
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]'
Var HTTP = require("https");var options = {host: 'api-sandbox.rev.com', path: '/api/v1/inputs', method: 'POST', headers: {'Authorization': 'Rev [ClientApiKey]:[UserAPIKey]', 'Content-Type': 'video/mp4', 'content-disposition': 'attachment;文件名= filename.mp4 '}};Var req = http。Request (options, (respp) => {respp . xml . xml . xml . xml . xml . xml . xml . xml . xml . xml . xml . xml . xml . xml。on("end", function () {console.log('Status Code:', resp.statusCode);console.log(的头:“resp.headers);});});要求的事情。write("@[INSERT FILE PATH HERE]"); req.end();
提交到发布/输入后,您应该收到与下面类似的响应。
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"]}}'
var https =要求('https');VAR post_data = JSON.stringify({caption_options:{输入:[{video_length_seconds:6,URI: '瓮启:inputmedia:RXVwbG9hZHMvMjAxOC0wNS0xNi8yY2UxYWFmNS04ZasdfQ4NzMtOGRmMC05Y2I2ZDkwN2ViNzIvbGVnb3ZpZGVvLm1wNA'}],output_file_formats:[ 'SubRip']}});var选项= {host:'api-sandbox.rev.com',路径:'/ api / v1 / domens',方法:'post',标题:{'授权':'rev [clientapikey]:[userapikey]','content-type':'application / json'}};var post_req = https.request(选项,(resp)=> {console.log('状态代码:',resp.statuscode); console.log('标题:',resp.headers);});post_req.write(post_data);post_req.end();
收到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.我们的一个工程师会回答。