Skip to main content

Asynchronous HTTP Interface

The asynchronous HTTP interface is a non-blocking HTTP API for transcribing long audio into text.

To use this API, follow these steps:

  1. Create a speech recognition job
  2. Poll to check the status of the speech recognition job and retrieve the results

The method for generating the job in step 1 is almost the same as the synchronous HTTP interface, except for how to specify logging options.

Endpoint​

Unlike the synchronous HTTP interface, the base endpoint is the same regardless of whether logging is enabled or not.

v2 (new version)

https://acp-api-async.amivoice.com/v2/recognitions

v1 (previous version)

https://acp-api-async.amivoice.com/v1/recognitions

For differences between v1 and v2, please see About the New Version.

caution
  • The old version of the asynchronous HTTP interface will be discontinued in the future. If you are currently using it, please migrate to v2.
  • Sentiment analysis functionality is not currently available in v2. If you need to use sentiment analysis, please use v1.

Authentication​

Specify the API key using one of the following methods. For how to obtain it, see How to Issue API Keys.

HTTP request header

Authorization: Bearer {API_KEY}

For creating a job, setting via request parameter (the u parameter) is also possible.

u={API_KEY}