Transcri API Documentation

Transcri Speech-to-Text API

API for BUSINESS users only

Introduction

Our API is designed to efficiently convert your audio files into text, while offering translation options to meet your multilingual needs. To start using our transcription API, follow the steps in the documentation in order and make sure you have access to your BUSINESS account in a new tab of your browser.

For any questions or additional assistance, please do not hesitate to contact our technical support.

Create my first API key

  • Log in to your account and access your dashboard, then navigate to Settings > Manage my API keys using the sidebar.

  • Click the dedicated button to create a new API key.Note that each subscription is limited to 3 API keys. If you need more keys, please contact us directly.

  • Fill out the form:

    Name #  Enter a unique and distinct name for each API key. This will help you identify each one.

    Webhook URL #  Specify a Webhook URL to receive the transcription results later. This allows you to receive the results without waiting, which is useful for transcriptions that may take several minutes.

    IP Restrictions #  Define the IPs allowed to use this API key. You can add up to 8 IPs per API key. If no IP is specified, the API key will be accessible from any IP.

    Limiting the IPs allowed for your API keys is a recommended practice to secure access to your services. An unrestricted API key can be vulnerable to abusive uses.

Edit API keys

REST API

#Retrieve total credit

Allows you to retrieve the remaining credits available for your account, expressed in seconds, before the next reset.
GET

https://www.api.transcri.io/api/v1/credits

  • Response

    200 OK

    RESPONSE SCHEMA:   application/json

    next_reset

    required

    string

    unit

    required

    string

    value

    required

    integer

    401 Unauthorized

    403 Forbidden

    500 Internal Server Error

  • Sample Request

    Sample Response

#Transcript a file

Instantly convert your audio into text with our automated transcription service.
POST

https://www.api.transcri.io/api/v1/transcript

Default
Webhook
  • Request

    file

    required

    file

    Audio or video file to transcribe

    model

    string

    Default advanced model

    input_language

    string

    File language (detected automatically if not specified)

    output_language

    string

    Output file language in ISO 3166-1 format (default is the file language)

    start_timer

    string

    Start point of the transcription in HH:MM:SS format

    end_timer

    string

    End of the transcription in HH:MM:SS format

    Response

    200 OK

    401 Unauthorized

    403 Forbidden

    422 Unprocessable Content

    500 Internal Server Error

  • Sample Request

    Sample Response

#Translate Text

Translate your text into the language you want.
POST

https://www.api.transcri.io/api/v1/translate-text

  • Request

    output_language

    required

    string

    Output file language in ISO 3166-1 format

    text

    required

    string

    Content obtained by transcription with Transcri.io

    Response

    200 OK

    401 Unauthorized

    403 Forbidden

    422 Unprocessable Content

    500 Internal Server Error

  • Sample Request

    Sample Response

#Translate segments

Translates your segments and text from a transcription into the language you want.
POST

https://www.api.transcri.io/api/v1/translate-segments

  • Request

    output_language

    required

    string

    Output file language in ISO 3166-1 format

    segments

    required

    array[]{text: string}

    Segments obtained by transcription with Transcri.io

    Response

    200 OK

    401 Unauthorized

    403 Forbidden

    422 Unprocessable Content

    500 Internal Server Error

  • Sample Request

    Sample Response

Webhook Signature

To ensure the security of your endpoint, each transcription is accompanied by a unique signature. This signature verifies the integrity and authenticity of the received data, ensuring that the request comes from our services.

Transcription quality rated by users :

4.8(339 votes)

You need to import at least 1 file to give a rating

Cookie consent

Welcome to Transcri!This site uses cookies and gives you control over which ones you wish to enable.