Call Media - Start Transcription

Usługa:
Communication
Wersja interfejsu API:
2025-06-15

Rozpoczyna transkrypcję w wywołaniu

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
callConnectionId
 path True

string

Identyfikator połączenia wywołania.
endpoint
 path True

string (url)

Punkt końcowy zasobu usługi Azure Communication.
api-version
 query True

string

Wersja interfejsu API do wywołania.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Authorization True

string

Token dostępu użytkownika usług Azure Communication Services.

Treść żądania

Nazwa Typ Opis
locale

string

Określa ustawienia regionalne używane do transkrypcji, np. en-CA lub en-AU.
operationCallbackUri

string

Ustaw identyfikator URI wywołania zwrotnego, który zastępuje domyślny identyfikator URI wywołania zwrotnego ustawiony przez element CreateCall/AnswerCall dla tej operacji. Ta konfiguracja jest wykonywana według akcji. Jeśli to nie zostanie ustawione, zostanie użyty domyślny identyfikator URI wywołania zwrotnego ustawiony przez element CreateCall/AnswerCall.
operationContext

string

Wartość identyfikująca kontekst operacji.
speechModelEndpointId

string

Identyfikator wdrożonego modelu niestandardowego w formacie identyfikatora GUID. Identyfikator GUID jest generowany przez usługę Azure Speech Studio, np. a259c255-1cdw-4ed7-a693-dd58563b6f6a.

Odpowiedzi

Nazwa Typ Opis
202 Accepted

Usługa zaakceptowała żądanie rozpoczęcia transkrypcji i rozpocznie jego przetwarzanie. Otrzymasz zdarzenie TranscriptionStarted lub TranscriptionFailed w określonym identyfikatorze URI wywołania zwrotnego w celu zaktualizowania stanu żądania.
Other Status Codes

CommunicationErrorResponse

Error

Zabezpieczenia

Authorization

Token dostępu użytkownika usług Azure Communication Services.

Typ: apiKey
W: header

Przykłady

CallMedia_StartTranscription

Przykładowe żądanie

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

{}

Przykładowa odpowiedź

Kod stanu:
202

Definicje

StartTranscriptionRequest

Objekt
Nazwa Typ Opis
locale

string

Określa ustawienia regionalne używane do transkrypcji, np. en-CA lub en-AU.
operationCallbackUri

string

Ustaw identyfikator URI wywołania zwrotnego, który zastępuje domyślny identyfikator URI wywołania zwrotnego ustawiony przez element CreateCall/AnswerCall dla tej operacji. Ta konfiguracja jest wykonywana według akcji. Jeśli to nie zostanie ustawione, zostanie użyty domyślny identyfikator URI wywołania zwrotnego ustawiony przez element CreateCall/AnswerCall.
operationContext

string

Wartość identyfikująca kontekst operacji.
speechModelEndpointId

string

Identyfikator wdrożonego modelu niestandardowego w formacie identyfikatora GUID. Identyfikator GUID jest generowany przez usługę Azure Speech Studio, np. a259c255-1cdw-4ed7-a693-dd58563b6f6a.