Call Media - Start Transcription

Servizio:

Communication

Versione API:

2025-05-15

Avvia la trascrizione nella chiamata

POST {endpoint}/calling/callConnections/{callConnectionId}:startTranscription?api-version=2025-05-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
callConnectionId	path	True	string	ID connessione di chiamata.
endpoint	path	True	string (url)	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Token di accesso utente di Servizi di comunicazione di Azure.

Corpo della richiesta

Nome	Tipo	Descrizione
locale	string	Specifica le impostazioni locali utilizzate per la trascrizione, ad esempio en-CA o en-AU.
operationCallbackUri	string	Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.
operationContext	string	Valore per identificare il contesto dell'operazione.
speechModelEndpointId	string	ID del modello personalizzato distribuito in formato GUID. Il GUID viene generato da Azure Speech Studio, ad esempio a259c255-1cdw-4ed7-a693-dd58563b6f6a.

Risposte

Nome	Tipo	Descrizione
202 Accepted		Il servizio ha accettato la richiesta di trascrizione iniziale e inizierà l'elaborazione. Si riceverà l'evento TranscriptionStarted o TranscriptionFailed all'URI di callback specificato per aggiornare lo stato della richiesta.
Other Status Codes	CommunicationErrorResponse	Errore

Sicurezza

Authorization

Token di accesso utente di Servizi di comunicazione di Azure.

Tipo: apiKey
In: header

Esempio

CallMedia_StartTranscription

Esempio di richiesta

HTTP

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:startTranscription?api-version=2025-05-15

{}

Risposta di esempio

Codice di stato:

202

Definizioni

StartTranscriptionRequest

Object

Nome	Tipo	Descrizione
locale	string	Specifica le impostazioni locali utilizzate per la trascrizione, ad esempio en-CA o en-AU.
operationCallbackUri	string	Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.
operationContext	string	Valore per identificare il contesto dell'operazione.
speechModelEndpointId	string	ID del modello personalizzato distribuito in formato GUID. Il GUID viene generato da Azure Speech Studio, ad esempio a259c255-1cdw-4ed7-a693-dd58563b6f6a.