当使用Rev转录服务时，您将与Rev.com或Rev.ai api进行接口。关于这些差异和用例的更多细节，点击这里查看我们的文章．如果你想学习如何使用Rev.com的API来实现99%准确的人工转录，点击这里．在本文中，我们将带您了解如何获得Rev.ai API的证书并运行，如何执行身份验证和登录，以及如何向各种端点提交请求以完成转录。

的牧师AI API提供机器生成的文字记录，而不是人工生成的文字记录，因此它更适合快速通话、快速周转时间，并将语音识别构建到应用程序和软件中。的Rev.com API当你能够等待大约12个小时，让转录专业人员来处理你的成绩单时，就可以得到高度准确的成绩单。

ai API使用先进的人工智能和机器学习来处理音频或视频文件，并生成准确的转录。更具体地说，它使用语音到文本模型来匹配音频中的扬声器，确定他们在说什么，并将结果记录为文本。ai算法足够聪明，可以解析说话人的单词，不管口音、不流畅、背景噪音和音频中的其他复杂因素。这些api允许您在业务帐户中进行身份验证、提交和管理请求、监控订单的状态，并以简单的下载方式接收转录结果。准备好开始了吗?

创建帐户并生成访问令牌

要开始使用这个API，你需要在Rev.ai主页。一旦你这样做了，登录到你的帐户，并继续到“访问令牌”链接在侧边栏。这会把你带到一个像这样的页面:

你需要点击“生成令牌”的按钮，并将结果复制到剪贴板上。这个访问令牌将是您进入Rev.ai api的关键，用于提交和管理您的转录命令。

你的账户将预装300分钟的免费转录，有足够的时间测试API，并评估它是否适合你的需要。让我们创建一个订单来开始。我们将使用带有预配置集合的公共Rev Postman工作区来帮助您调用Rev API。您可以访问工作区在这里．

继续并打开工作区。在左侧，您可以单击Rev.ai API收集下拉框。你会看到一个像这样的菜单:

继续，点击“用本地文件提交作业”。通常在我们提交作业之前，我们需要添加一个叫做授权头的请求。幸运的是，这个工作区已经为我们配置了一个，所以不需要担心它。这个头文件允许你使用Rev.ai API进行身份验证。我们可以在“Authorization”选项卡下查看它的配置。

现在，Rev.ai API有两个不同的版本。第一个是异步API它允许你提交作业，并让它们在后台处理。然后可以配置API，以便在作业完成时通知您，您可以下载您的转录。这是大多数人将使用的API版本。

另一个版本是流API用于需要实时转录的工作。这可能很有用，例如，如果您正在直播一个播客，并希望为您的用户动态生成转录，但您不想花钱请一个现场转录员。我们将在这篇文章中介绍异步API。

的基url异步API的

https://api.rev.ai/speechtotext/v1

这是端点被追加到的URL。因此，每个请求将被发送到这个url，加上一个指定要使用的函数的特定端点。为了提交抄写工作，我们会用工作端点。

提交一个文件

有两种方法可以向Rev.ai API提交文件。第一种方法是将文件托管在某个服务器上(比如您的网站或播客平台)，然后将Rev.ai指向它。它通过一个名为“media_url”的键传递给API。对于大多数用户来说，这可能是最方便的方式，因为通过请求提交url比通过文件提交url更容易一些。ai会在后台处理文件的下载，所以不用担心。请注意,您不能使用YouTube URL，因为这不是直接下载链接。

提交文件的另一种方法是直接上传，作为POST请求的一部分发送到API。为此，您需要使用一种名为多部分/格式．注意，如果您使用这种格式，您将被限制为小于2gb的文件大小。这就是我们将在本教程中使用的内容。下面是如何在Postman中提供文件。导航到“body”选项卡，并将鼠标悬停在“Key”字段上。您应该会看到一个小的下拉字段出现。点击并选择“文件”。

现在你可以点击VALUE下面的“选择文件”按钮来上传你的文件。在这个测试中，我将使用一个包含Fresh Prince of Bel-Air主题曲的MP3音频文件。在KEY的方框中键入“media”。

您还可以提供一个带有json值的" options "键，该值指定与请求一起使用的选项。API文档中提供了完整的选项列表。我们将提供一个名为“元数据”的选项，它允许我们指定音频文件的简短描述，以便将来引用它。

一旦您在进行的所有信息中，继续进入URL，请确保选中POST作为请求类型，然后单击“发送”。

如果请求成功，您应该得到如下的响应。

您可以看到它包含请求的ID、创建日期、音频文件的名称、我们提供的元数据描述、转录进度的当前状态以及我们使用的API的类型，在我们的示例中是“async”。

现在Rev.ai机器学习模型正在处理我们的请求，让我们继续并密切关注它。我们将创建一个新的GET请求，用于查询API并检查该作业的状态。继续并点击左边面板上的“转录工作->获取工作”。

这个请求将比前一个简单得多。我们使用完全相同的URL，但是我们将请求类型设置为get。我们还使用与前面相同的授权头。最后，我们添加一个名为“id”的键，并将其值设置为我们在响应原始POST请求时收到的订单id。

如果请求成功，您应该看到如上所示的结果。你会看到我们的订单已经完成，文件也被转录了。现在我们只需要下载转录文件!

获得成绩单

要下载我们的transcript，我们将使用/jobs端点的“transcript”特性。这将是一个简单的GET请求。继续并点击左边面板上的“Outputs -> Get Transcript”。

和前面一样，为请求设置报头。你会看到有一个额外的header叫做“Accept”，它告诉API我们想以什么格式接收数据。我们的选择是:

应用程序/ vnd.rev.transcript.v1.0 + json

或

文本/平原

为简单起见，我们将使用文本/平原它会给我们纯文本输出，然后我们可以复制到一个Word文档或类似的文件。JSON版本非常有用，因为它为转录中的每个单词提供了置信度评分。然后，您可以使用这些工具，例如，过滤和手动纠正低置信分数的单词。

完成后应该是这样的:

现在，我们可以提交最后的请求了。拿到成绩单的全部终点是

/工作/ {id} /成绩单

您需要将url中的{id}替换为您实际的作业id。让我们来看看请求URL的最终版本，以及作为响应返回的纯文本文本记录输出:

现在你有了它，您的指南提交成绩单订单与Rev AI在邮差从开始到结束!