L'API Speech-to-Text di Transcri

Introduzione

La nostra API è progettata per convertire efficacemente i tuoi file audio in testo, offrendo anche opzioni di traduzione per soddisfare le tue esigenze multilingue. Per iniziare a utilizzare la nostra API di trascrizione, segui in ordine i passaggi della documentazione e assicurati di avere accesso al tuo account BUSINESS su una nuova scheda del tuo browser.

Per qualsiasi domanda o assistenza aggiuntiva, non esitare a contattare il nostro supporto tecnico.

Creare la mia prima chiave API

Accedi al tuo account e accedi al tuo dashboard poi naviga verso Impostazioni > Gestisci le mie chiavi API usando la barra di navigazione laterale.
Clicca sul pulsante dedicato per creare una nuova chiave API.Nota che ogni abbonamento è limitato a 3 chiavi API. Se hai bisogno di più chiavi, per favore contattaci direttamente.
Compila il modulo:
Nome # Inserisci un nome unico e distintivo per ogni chiave API. Questo ti permetterà di identificare ciascuna di esse.
URL Webhook # Specifica un URL Webhook per ricevere i risultati delle trascrizioni successivamente. Questo permette di ricevere i risultati senza attendere, il che è utile per trascrizioni che possono richiedere diversi minuti.
Restrizioni IP # Definisci gli IP autorizzati a usare questa chiave API. Puoi aggiungere fino a 8 IP per chiave API. Se nessun IP è specificato, la chiave API sarà accessibile da qualsiasi IP.
Limitare gli IP autorizzati per le tue chiavi API è una pratica raccomandata per proteggere l'accesso ai tuoi servizi. Una chiave API non restrittiva può essere vulnerabile a usi impropri.

REST API

#Recuperare il credito totale

Permette di recuperare i crediti rimanenti disponibili per il tuo account, espressi in secondi, prima del prossimo reset.

GET

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

Risposta
200 OK
SCHEMA DI RISPOSTA: application/json
next_reset
richiesto
string
unit
richiesto
string
value
richiesto
integer
401 Unauthorized
403 Forbidden
500 Internal Server Error
Esempio di richiesta
Esempio di risposta

#Trascrivere un file

Trasforma il tuo audio in testo in un attimo con il nostro servizio di trascrizione automatizzato.

POST

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

Predefinito

Webhook

Richiesta

file

richiesto

file

File audio o video da trascrivere

input_language

string[predefinito null]

Lingua del file (rilevata automaticamente se non specificata)

output_language

string[predefinito null]

Lingua di output del file nel formato ISO 3166-1 (predefinito è la lingua del file)

start_timer

string[predefinito null]

Punto di inizio della trascrizione nel formato HH:MM:SS

end_timer

string[predefinito null]

Punto finale della trascrizione nel formato HH:MM:SS

is_multilingual

bool[predefinito false]

Determina se il tuo audio contiene più lingue

subtitles_config

object[predefinito [42, 2, 5]] {

maximum_characters_per_row: int,

maximum_rows_per_caption: int,

maximum_duration: int

}

Configurazione dei sottotitoli

diarization

boolean[predefinito false]

Attiva l'identificazione degli oratori (limitata alle prime 2 ore di audio)

diarization_config

object[predefinito [null]] {

number_of_speakers: ?int

}

Configurazione dell'identificazione degli oratori

custom_metadata

object[predefinito [{}]]

Metadati personalizzati che puoi allegare a questa trascrizione

Risposta

200 OK

401 Unauthorized

403 Forbidden

422 Unprocessable Content

500 Internal Server Error

Esempio di richiesta
Esempio di risposta

#Tradurre del testo

Traduci il tuo testo nella lingua che desideri.

POST

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

Richiesta
output_language
richiesto
string
Lingua di output del file nel formato ISO 3166-1
text
richiesto
string
Contenuto ottenuto dalla trascrizione con Transcri
Risposta
200 OK
401 Unauthorized
403 Forbidden
422 Unprocessable Content
500 Internal Server Error
Esempio di richiesta
Esempio di risposta

#Tradurre dei segmenti

Traduci i tuoi segmenti così come il tuo testo proveniente da una trascrizione nella lingua che desideri.

POST

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

Richiesta
output_language
richiesto
string
Lingua di output del file nel formato ISO 3166-1
segments
richiesto
array[]{text: string}
Segmenti ottenuti dalla trascrizione con Transcri
Risposta
200 OK
401 Unauthorized
403 Forbidden
422 Unprocessable Content
500 Internal Server Error
Esempio di richiesta
Esempio di risposta

Firma Webhook

Per garantire la sicurezza del tuo endpoint, ogni trascrizione è accompagnata da una firma unica. Questa firma permette di verificare l'integrità e l'autenticità dei dati ricevuti, garantendo che la richiesta provenga effettivamente dai nostri servizi.