使用Rev转录服务时，您将与Rev.com或Rev.ai API联系。有关这些差异和用例的更多详细信息，在这里看我们的文章．在这篇文章中，我们将带您了解如何获得Rev.com API的证书并运行，如何执行身份验证和登录，以及如何向不同的端点提交请求以完成您的转录。（笔记：如果您正在寻找如何设置Rev.ai API的分步指南，你可以在这里找到．）

如果你不是最懂科技的人，不要害怕。API只是应用程序接口．此接口定义了一组终点哪些用户提交要求为了触发来自后端系统的不同行为。这些请求通常是HTTP请求，即它们是通过与你访问网站时使用的相同的HTTP协议提交的。数据通常使用结构化格式(如XML或JSON)发送到端点或从端点发送出去。如果您有编程背景，那么您可能已经熟悉api和这些类型的请求。如果没有，你会很快跟上。使用API所需要的就是使用Python等语言中的几行代码，或者使用用户友好的工具，例如邮差．

从沙箱开始

出于本文的目的，我们将使用Rev API沙箱向您展示如何创建身份验证凭据、提交订单和查询端点、从API接收回数据等等。沙箱允许我们在一个试验的基础上做所有这些，以便您可以熟悉系统和订单工作流，而不产生任何费用。

我们将从Rev.com API开始。首先，首先，您需要请求沙箱的凭据。这样做，参观这个链接然后点击高亮显示的文本“如果你没有这些钥匙为沙箱，你可以在这里得到它们。”将信息键入弹出的表单，您的新沙盒键将通过电子邮件发送给您。你会得到两个API键：客户端密钥和用户密钥。将它们复制到本地硬盘驱动器上的安全位置。

接下来，我们将提出我们的第一个请求！我们建议您使用邮递员为您可以下载的本教程在这里．或者，您可以使用可用于Rev.com API的许多SDK之一红宝石那PHP.， 或者Python．如果您有应用程序的应用程序，这些源代码是很好的，这些源代码需要代表您的Rev API。

当提交一个Rev.com API请求时，你将使用一个与你想要使用的特定功能相关联的特定URL。每个这样的URL可以分为三个部分:

https:// {base_url} / {version_number} /{函数}

基础url用于指向Rev的后端。对于沙盒，这是API -sandbox.rev.com，对于产品API，这很简单www.vitsmart.com.．接下来，我们包含一个版本号，比如“v1”，对应于我们想要使用的API版本。事实上，v1是目前唯一可用的版本，但这可能在未来改变。最后，函数变量是指您希望从给定API请求中获得的特定功能。这可以是“订单”，以获得与您的帐户相关的所有订单，或“附件”，以添加一个附件到您的订单。

我们的第一个要求：获取订单

现在，让我们创建我们的第一个请求。抛出邮递员，你将用一个看起来这样的屏幕呈现。

单击“请求”按钮以创建基本请求。然后，您将看到一个新的屏幕弹出，要求您命名请求，提供可选描述，并指定保存请求的集合。您可以为Rev.com API请求创建一个集合，并编写一个看起来像这样的名称和描述：

一旦完成，我们将能够创建实际请求。这将是一个get请求，意思是它从Rev服务器获取一些信息，在这种情况下，与我们的帐户相关联的订单列表。我们放置URL“https://api-sandbox.rev.com/api/v1/orders.“在URL框中，然后点击”授权“选项卡以向我们的请求添加一些授权标题。这是Rev API在系统中验证我们的原因，并检索与我们的帐户关联的订单。我们使用关键的“授权”和“Rev Client_key：user_key”，其中您将Client_key和User_key变量替换为为您生成的键。您现在可以点击“发送”以生成并发送请求。

如果一切顺利，你会看到如下截图所示的回应:

您将看到值“total_count”设置为0，列表“订单”是空的，因为我们目前没有与我们的帐户关联的订单。让我们解决这个问题。

创建新订单

创建一个新的请求并将其命名为之前。此请求将与上次不同，因为它是一个帖子请求，这意味着我们将向Rev.com API发送数据。URL与以前相同。您还需要添加像上次请求的授权标题。

现在，我们需要为我们的请求添加一个额外的参数。这是请求身体．因为我们正在创建一个POST请求，所以我们提供了一个JSON参数字典，为Rev.com API提供关于订单的信息。下面是我们将用于这个顺序的示例字典。

{/ *可选，对于客户端* /“client_ref”的订单的参考编号：“我的第一个订单”，/ *强制性，提供有关需要转录的内容的信息，并允许设置任何转录选项。* /“transcription_options”：{/ *强制性，包含要传授的媒体列表。必须具有至少一个元素* /“输入”：[介质的URI，从呼叫返回到发布/输入* /“External_Link”：“https://www.youtube.com/watch?v= f5njqiy9auy“，/ *可选，扬声器名称列表。兼容任何输入格式。* /“扬声器”：[“比尔盖茨”，“Ellen Degeneres”]，/ *可选，词汇表项列表。兼容任何输入格式。* /“词汇表”：[“自由勋章”]，/ *可选，扬声器口音清单。兼容任何输入格式。* /“口音”：[“Americanneutral”，“Americansouthern”]}]，/ *可选，我们应该通过转录提供的文件逐字吗？如果是真，则将包括所有填充字（即umm，uhh）。 Requesting Verbatim adds $0.25 / minute to the cost of your orders. */ "verbatim": true, /* Optional, should we include timestamps? Timestamps are available in the JSON format, and are free. We make a best effort for the timestamps to be per-word, but do not guarantee it. */ "timestamps": true, /* Optional, should we rush this order? Rush will deliver your files up to 5x faster. Requesting Rush adds $1.25 per audio minute to the cost of your orders. We expect a high degree of accuracy with these files. However, speaker names may be inconsistent for files over 30 minutes. */ "rush": false, /* Optional, should we create an instant machine-generated first draft? Requesting an Instant First Draft adds $0.25 per audio minute to the cost of your orders. */ "instant_first_draft": true, /* Optional, what file formats should the transcripts be optimized for. See table in description section for supported formats. By default, we optimize for Microsoft Word. */ "output_file_formats": ["MS Word", "JSON"] } }

复制此JSON并将其粘贴到Postman中的主体文本框中。确保从下拉列表中选择了“JSON”作为数据类型。您将看到，在这个字典中，我们有许多不同的参数，它们描述了对Rev客户端后端的订单的不同方面。希望文中的评论已经足够清楚了，但我们还是会讨论一些细节，以防万一。对于这个请求，我们有一个“输入”列表。一个订单可以包含您想要转录的多个输入媒体文件。这个订单只有一个，那就是在艾伦·德杰尼勒斯秀上对比尔·盖茨的采访。我们提供了一个链接到指定Youtube采访视频的URL。我们还提供了一些演讲者的详细信息，即比尔·盖茨和艾伦·德杰尼勒斯。注意到我们是如何包含重音类型的列表来帮助提高转录的准确性的吗? We mark Bill Gates’ accent as “AmericanNeutral.” While Ellen doesn’t really have an accent, she is from New Orleans, so we’ll mark her accent as “AmericanSouthern” just to illustrate another option. We can also provide a glossary of uncommon terms that might show up in the transcription and be helpful for transcribers to know. For this media, we provide the glossary term “Medal of Freedom.”

最后，我们提供了一些用于指定订单的详细信息的其他元数据。我们可以指定转录的输出格式，无论我们希望逐字转录的文件，无论我们想要订单是否冲。一些选项都会产生额外费用，因此请务必在使用前研究文档中的每个参数它。以下是最终请求与请求机构到位的情况。请务必仔细检查一切，然后单击“发送”以提交作业！

现在，让我们回到我们的订单获取请求以确保已收到订单。由于请求已经设置，我们不应需要添加任何信息。只需单击“发送”，查看响应机构中返回的内容。您现在应该读取读取的数据，这些数据看起来像这样：

{“total_count”：1，“结果_per_page”：25，“页面”：0，“订单”：[order_number“：”tc0240018586“，”client_ref“：”我的第一个订单“，”价格“：10.55000，”状态“：”完整“，”优先级“：”正常“，”non_standard_tat_guarantee“：false，”转录“：{”verbatim“：true，”timestamps“：true，”total_length“：6，”total_length_seconds“：394}，“评论”：[]，“附件”：[]}]}

您可以看到我们的订单已创建以独特的订单号，相关价格，状态（我是“完成”），因为它已经运行了一段时间，而且更多。

获得他们的转录

等待几分钟，然后向订单端点提交另一个GET请求。您的订单应显示为当时的“已完成”表示该文件已被转录。一旦该状态显示，我们需要再次请求获得最终转录并将其下载到计算机。为此，我们将一个参数添加到Orders Endpoint的URL上：我们的订单号。URL应该看起来像这样：

https://api-sandbox.rev.com/api/v1/orders/tc0240018586.

您应该使用从API响应所采取的订单号来替换“TC0240018586”。再次，您需要将此指定为GET请求并提供授权标题。准备好请求后，单击“发送”。你应该被打招呼，这是一个看起来像这样的东西：

我们将为清楚起见提供整个JSON的响应。

{“tern_number”：“tc0240018586”，“client_ref”：“我的第一个订单”，“价格”：10.55000，“状态”：“完整”，“优先”：“正常”，“non_standard_tat_guarantee”：false，“转录”：{“verbatim”：true，“timestamps”：true，“total_length”：6，“total_length_seconds”：394}，“评论”：[{“by”：“”“，”时间戳“：”2021-05-07T00：35：57.873z“，”文本“：”}，{“时间戳”：“2021-05-07T00：36：06.23z”，“文本”：“首次与艾伦聊天”是重命名为“比尔盖茨与ellen聊天”第一次.mp4“}，{”时间戳“：”2021-05-07T00：41：09.807Z“，”Text“：”订单“，”}“，”附件“：[【善良“：”媒体“，”名称“：”比尔盖茨与ellen聊天第一个时间.mp4“，”mmrodtbicaaaaaaaaaaa“，”audio_length_seconds“：394，”链接“：[{”rel“：”内容“，”href“：”https://api-sandbox.rev.com/api/v1/Attachments/mmrodtbicaaaaaaaagaaaa/content“}”}，{种类型“：”抄本“，”名称“：“比尔盖茨与埃伦聊天第一次.DOCX”，“ID”：“MMRODTJICAAAAAAAABQAAAa“，”链接“：[{”rel“：”内容“，”href“：”https://api-sandbox.rev.com/api/v1/Attachments/mmrodtjicaaaaaabqaaaa/content“，”content-type“：“application / vnd.openxmlformats-officedocument.wordprocessingml.document”}“}]}}

您可以看到，已经填充了两个不在GET ALL ORDERS端点中的新字段:注释和附件。“Comments”只包含关于订单的各种注释。《依恋》才是真正神奇的地方。在这里你可以找到链接，下载你所要求的任何格式的转录本。我们要求在MS Word和JSON格式的转录，所以我们提供了两个这样的链接。现在，如果你真的导航到这些url，你会得到一个“Page not found”错误。这仅仅是因为我们使用了沙箱，没有支付转录费用。在API的真实版本中，您将能够导航到这些url，并将它们下载到您的计算机上。

这就是它的全部，整个Rev.com订单从开始完成！