Freigeben über


Transcriptions - Create

Erstellt eine neue Transkription.

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
path True

string

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://westus.api.cognitive.microsoft.com).

Anforderungstext

Name Erforderlich Typ Beschreibung
displayName True

string

minLength: 1

Der Anzeigename des Objekts.

locale True

string

minLength: 1

Das Gebietsschema der enthaltenen Daten. Wenn die Sprachidentifikation verwendet wird, wird dieses Gebietsschema verwendet, um die Sprache zu transkribieren, für die keine Sprache erkannt werden konnte.

contentContainerUrl

string (uri)

Eine URL für einen Azure-Blobcontainer, der die Audiodateien enthält. Ein Container darf eine maximale Größe von 5 GB und eine maximale Anzahl von 10000 BLOBs aufweisen. Die maximale Größe für ein Blob beträgt 2,5 GB. Container-SAS sollte die Berechtigungen "r" (lesen) und "l" (Liste) enthalten. Diese Eigenschaft wird in einer Antwort nicht zurückgegeben.

contentUrls

string[] (uri)

Eine Liste der Inhalts-URLs zum Abrufen von Audiodateien zum Transkribieren. Bis zu 1000 URLs sind zulässig. Diese Eigenschaft wird in einer Antwort nicht zurückgegeben.

customProperties

object

Die benutzerdefinierten Eigenschaften dieser Entität. Die maximal zulässige Schlüssellänge beträgt 64 Zeichen, die maximal zulässige Wertlänge beträgt 256 Zeichen und die Anzahl zulässiger Einträge beträgt 10.

dataset

EntityReference

EntityReference

description

string

Die Beschreibung des Objekts.

model

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

TranscriptionProperties

TranscriptionProperties

Antworten

Name Typ Beschreibung
201 Created

Transcription

Die Antwort enthält Informationen zur Entität als Nutzlast und deren Position als Header.

Header

Location: string

Other Status Codes

Error

Ein Fehler ist aufgetreten.

Sicherheit

Ocp-Apim-Subscription-Key

Stellen Sie hier Ihren kognitiven Leistungskontoschlüssel bereit.

Typ: apiKey
In: header

Authorization

Stellen Sie ein Zugriffstoken von JWT bereit, das vom STS dieser Region zurückgegeben wird. Stellen Sie sicher, dass Sie dem Token den Verwaltungsbereich hinzufügen, indem Sie der STS-URL die folgende Abfragezeichenfolge hinzufügen: ?scope=speechservicesmanagement

Typ: apiKey
In: header

Beispiele

Create a transcription for URIs
Create a transcription from blob container
Create a transcription with basic two-speaker diarization
Create a transcription with language identification
Create a transcription with multispeaker diarization

Create a transcription for URIs

Beispielanforderung

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation",
    "https://contoso.com/myotherstoragelocation"
  ],
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription using default model for en-US"
}

Beispiel für eine Antwort

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription from blob container

Beispielanforderung

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentContainerUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/audiofiles/",
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription of storage container using default model for en-US"
}

Beispiel für eine Antwort

Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683
{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with basic two-speaker diarization

Beispielanforderung

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription using basic two-speaker diarization"
}

Beispiel für eine Antwort

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using basic two-speaker diarization",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with language identification

Beispielanforderung

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "languageIdentification": {
      "mode": "Single",
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
        }
      }
    }
  },
  "locale": "fr-FR",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale."
}

Beispiel für eine Antwort

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S",
    "languageIdentification": {
      "mode": "Single",
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
        }
      }
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "fr-FR",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale.",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with multispeaker diarization

Beispielanforderung

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "diarization": {
      "speakers": {
        "minCount": 3,
        "maxCount": 5
      }
    }
  },
  "locale": "en-US",
  "displayName": "Transcription using diarization for audio that is known to contain speech from 3-5 speakers"
}

Beispiel für eine Antwort

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S",
    "diarization": {
      "speakers": {
        "minCount": 3,
        "maxCount": 5
      }
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using diarization for audio that is known to contain speech from 3-5 speakers",
  "customProperties": {
    "key": "value"
  }
}

Definitionen

Name Beschreibung
DetailedErrorCode

DetailedErrorCode

DiarizationProperties

DiarizationProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

EntityError

EntityError

EntityReference

EntityReference

Error

Fehler

ErrorCode

Fehlercode

InnerError

InnerError

LanguageIdentificationMode

LanguageIdentificationMode

LanguageIdentificationProperties

LanguageIdentificationProperties

ProfanityFilterMode

ProfanityFilterMode

PunctuationMode

InterpunktionMode

Status

Status

Transcription

Transkription

TranscriptionLinks

TranscriptionLinks

TranscriptionProperties

TranscriptionProperties

DetailedErrorCode

DetailedErrorCode

Wert Beschreibung
DataImportFailed

Fehler beim Datenimport.

DeleteNotAllowed

Löschen nicht zulässig.

DeployNotAllowed

Bereitstellen nicht zulässig.

DeployingFailedModel

Fehler beim Bereitstellen des Modells.

EmptyRequest

Leere Anforderung.

EndpointCannotBeDefault

Der Endpunkt kann nicht standardmäßig sein.

EndpointNotUpdatable

Endpunkt nicht aktualisierbar.

EndpointWithoutLogging

Endpunkt ohne Protokollierung.

ExceededNumberOfRecordingsUris

Die Anzahl der Aufzeichnungs-URIs wurde überschritten.

FailedDataset

Fehler beim Dataset.

Forbidden

Verboten.

InUseViolation

Verletzung des Einsatzes.

InaccessibleCustomerStorage

Nicht zugänglicher Kundenspeicher.

InvalidAdaptationMapping

Ungültige Anpassungszuordnung.

InvalidBaseModel

Ungültiges Basismodell.

InvalidCallbackUri

Ungültiger Rückruf-URI.

InvalidCollection

Ungültige Auflistung.

InvalidDataset

Ungültiges Dataset.

InvalidDocument

Ungültiges Dokument.

InvalidDocumentBatch

Ungültiger Dokumentbatch.

InvalidLocale

Ungültiges Gebietsschema.

InvalidLogDate

Ungültiges Protokolldatum.

InvalidLogEndTime

Ungültige Protokollendzeit.

InvalidLogId

Ungültige Protokoll-ID.

InvalidLogStartTime

Ungültige Startzeit des Protokolls.

InvalidModel

Ungültiges Modell.

InvalidModelUri

Ungültiger Modell-URI.

InvalidParameter

Ungültiger Parameter.

InvalidParameterValue

Ungültiger Parameterwert.

InvalidPayload

Ungültige Nutzlast.

InvalidPermissions

Ungültige Berechtigungen.

InvalidPrerequisite

Ungültige Voraussetzung.

InvalidProductId

Ungültige Produkt-ID.

InvalidProject

Ungültiges Projekt.

InvalidProjectKind

Ungültige Projektart.

InvalidRecordingsUri

Ungültiger Aufzeichnungs-URI.

InvalidRequestBodyFormat

Ungültiges Anforderungstextformat.

InvalidSasValidityDuration

Ungültige Gültigkeitsdauer für sas.

InvalidSkipTokenForLogs

Ungültiges Skip-Token für Protokolle.

InvalidSourceAzureResourceId

Ungültige Azure-Quellressourcen-ID.

InvalidSubscription

Ungültiges Abonnement.

InvalidTest

Ungültiger Test.

InvalidTimeToLive

Ungültige Zeit für live.

InvalidTopForLogs

Ungültiger Anfang für Protokolle.

InvalidTranscription

Ungültige Transkription.

InvalidWebHookEventKind

Ungültiger Web hook-Ereignistyp.

MissingInputRecords

Fehlende Eingabedatensätze.

ModelCopyOperationExists

Der Modellkopievorgang ist vorhanden.

ModelDeploymentNotCompleteState

Der Status der Modellbereitstellung ist nicht abgeschlossen.

ModelDeprecated

Das Modell ist veraltet.

ModelExists

Das Modell ist vorhanden.

ModelMismatch

Modellkonflikt.

ModelNotDeployable

Das Modell kann nicht bereitgestellt werden.

ModelVersionIncorrect

Modellversion falsch.

NoUtf8WithBom

No utf8 with bom.

OnlyOneOfUrlsOrContainerOrDataset

Nur eine url oder ein Container oder Dataset.

ProjectGenderMismatch

Project gender mismatch.

QuotaViolation

Kontingentverletzung.

SingleDefaultEndpoint

Einzelner Standardendpunkt.

SkuLimitsExist

Sku-Grenzwerte sind vorhanden.

SubscriptionNotFound

Das Abonnement wurde nicht gefunden.

UnexpectedError

Unerwarteter Fehler.

UnsupportedClassBasedAdaptation

Nicht unterstützte klassenbasierte Anpassung.

UnsupportedDelta

Nicht unterstütztes Delta.

UnsupportedDynamicConfiguration

Nicht unterstützte dynamische Konfiguration.

UnsupportedFilter

Nicht unterstützter Filter.

UnsupportedLanguageCode

Nicht unterstützter Sprachcode.

UnsupportedOrderBy

Nicht unterstützte Reihenfolge nach.

UnsupportedPagination

Nicht unterstützte Paginierung.

UnsupportedTimeRange

Nicht unterstützter Zeitraum.

DiarizationProperties

DiarizationProperties

Name Typ Beschreibung
speakers

DiarizationSpeakersProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

Name Typ Beschreibung
maxCount

integer (int32)

minimum: 1

Die maximale Anzahl von Lautsprechern für die Diarisierung. Muss kleiner als 36 und größer als oder gleich der minSpeakers-Eigenschaft sein.

minCount

integer (int32)

minimum: 1

Ein Hinweis für die minimale Anzahl von Lautsprechern für die Diarisierung. Muss kleiner oder gleich der maxSpeakers-Eigenschaft sein.

EntityError

EntityError

Name Typ Beschreibung
code

string

Der Code dieses Fehlers.

message

string

Die Meldung für diesen Fehler.

EntityReference

EntityReference

Name Typ Beschreibung
self

string (uri)

Der Speicherort der Entität, auf die verwiesen wird.

Error

Fehler

Name Typ Beschreibung
code

ErrorCode

Fehlercode
Fehlercodes auf hoher Ebene.

details

Error[]

Zusätzliche unterstützende Details zu den Fehler- und/oder erwarteten Richtlinien.

innerError

InnerError

InnerError
Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).

message

string

Fehlermeldung auf hoher Ebene.

target

string

Die Quelle des Fehlers. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

ErrorCode

Fehlercode

Wert Beschreibung
Conflict

Stellt den Konfliktfehlercode dar.

Forbidden

Stellt den verbotenen Fehlercode dar.

InternalCommunicationFailed

Fehlercode für die interne Kommunikation.

InternalServerError

Stellt den internen Fehlercode des Servers dar.

InvalidArgument

Stellt den fehlercode für ungültiges Argument dar.

InvalidRequest

Stellt den ungültigen Anforderungsfehlercode dar.

NotAllowed

Stellt den nicht zulässigen Fehlercode dar.

NotFound

Stellt den nicht gefundenen Fehlercode dar.

PipelineError

Stellt den Pipelinefehlerfehlercode dar.

ServiceUnavailable

Stellt den dienst nicht verfügbaren Fehlercode dar.

TooManyRequests

Stellt den Fehlercode für zu viele Anforderungen dar.

Unauthorized

Stellt den nicht autorisierten Fehlercode dar.

UnprocessableEntity

Stellt den nicht verarbeiteten Entitätsfehlercode dar.

UnsupportedMediaType

Stellt den Fehlercode für den nicht unterstützten Medientyp dar.

InnerError

InnerError

Name Typ Beschreibung
code

DetailedErrorCode

DetailedErrorCode
Detaillierte Fehlercode-Enumeration.

details

object

Zusätzliche unterstützende Details zu den Fehler- und/oder erwarteten Richtlinien.

innerError

InnerError

InnerError
Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).

message

string

Fehlermeldung auf hoher Ebene.

target

string

Die Quelle des Fehlers. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

LanguageIdentificationMode

LanguageIdentificationMode

Wert Beschreibung
Continuous

Fortlaufende Sprachidentifikation (Standard).

Single

Identifizierung einzelner Sprachen.

LanguageIdentificationProperties

LanguageIdentificationProperties

Name Typ Standardwert Beschreibung
candidateLocales

string[]

Die Gebietsschemas für die Spracherkennung (Beispiel ["en-US", "de-DE", "es-ES"]). Mindestens 2 und maximal 10 Kandidatengebietsschemas, einschließlich des Hauptgebietsschemas für die Transkription, werden unterstützt.

mode

LanguageIdentificationMode

Continuous

LanguageIdentificationMode
Der Modus, der für die Sprachidentifikation verwendet wird.

speechModelMapping

<string,  EntityReference>

Eine optionale Zuordnung von Gebietsschemas zu Sprachmodellentitäten. Wenn kein Modell für ein Gebietsschema angegeben wird, wird das Standardbasismodell verwendet. Schlüssel müssen Gebietsschemas sein, die in den Kandidatengebietsschemas enthalten sind, Werte sind Entitäten für Modelle der jeweiligen Gebietsschemas.

ProfanityFilterMode

ProfanityFilterMode

Wert Beschreibung
Masked

Maskiert die Profanität mit * mit Ausnahme des ersten Buchstabens, z.B. f***

None

Deaktivieren Sie die Profanitätsfilterung.

Removed

Entfernen Sie Profanität.

Tags

Hinzufügen von "Profanity"-XML-Tags</Profanity->

PunctuationMode

InterpunktionMode

Wert Beschreibung
Automatic

Automatische Interpunktion.

Dictated

Diktierende Interpunktionszeichen, d. h. explizite Interpunktion.

DictatedAndAutomatic

Diktierende Interpunktionszeichen oder automatische Interpunktion.

None

Keine Interpunktion.

Status

Status

Wert Beschreibung
Failed

Fehler beim vorgang mit langer Ausführung.

NotStarted

Der lange ausgeführte Vorgang wurde noch nicht gestartet.

Running

Der lange ausgeführte Vorgang wird zurzeit verarbeitet.

Succeeded

Der lange ausgeführte Vorgang wurde erfolgreich abgeschlossen.

Transcription

Transkription

Name Typ Beschreibung
contentContainerUrl

string (uri)

Eine URL für einen Azure-Blobcontainer, der die Audiodateien enthält. Ein Container darf eine maximale Größe von 5 GB und eine maximale Anzahl von 10000 BLOBs aufweisen. Die maximale Größe für ein Blob beträgt 2,5 GB. Container-SAS sollte die Berechtigungen "r" (lesen) und "l" (Liste) enthalten. Diese Eigenschaft wird in einer Antwort nicht zurückgegeben.

contentUrls

string[] (uri)

Eine Liste der Inhalts-URLs zum Abrufen von Audiodateien zum Transkribieren. Bis zu 1000 URLs sind zulässig. Diese Eigenschaft wird in einer Antwort nicht zurückgegeben.

createdDateTime

string (date-time)

Der Zeitstempel, zu dem das Objekt erstellt wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

customProperties

object

Die benutzerdefinierten Eigenschaften dieser Entität. Die maximal zulässige Schlüssellänge beträgt 64 Zeichen, die maximal zulässige Wertlänge beträgt 256 Zeichen und die Anzahl zulässiger Einträge beträgt 10.

dataset

EntityReference

EntityReference

description

string

Die Beschreibung des Objekts.

displayName

string

minLength: 1

Der Anzeigename des Objekts.

lastActionDateTime

string (date-time)

Der Zeitstempel, zu dem der aktuelle Status eingegeben wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

links

TranscriptionLinks

TranscriptionLinks

locale

string

minLength: 1

Das Gebietsschema der enthaltenen Daten. Wenn die Sprachidentifikation verwendet wird, wird dieses Gebietsschema verwendet, um die Sprache zu transkribieren, für die keine Sprache erkannt werden konnte.

model

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

TranscriptionProperties

TranscriptionProperties

self

string (uri)

Der Speicherort dieser Entität.

status

Status

Status
Beschreiben des aktuellen Status der API

TranscriptionLinks

Name Typ Beschreibung
files

string (uri)

Der Speicherort zum Abrufen aller Dateien dieser Entität. Weitere Informationen finden Sie unter Operation "Transcriptions_ListFiles".

TranscriptionProperties

TranscriptionProperties

Name Typ Beschreibung
channels

integer[] (int32)

Eine Sammlung der angeforderten Kanalnummern. Im Standardfall werden die Kanäle 0 und 1 berücksichtigt.

destinationContainerUrl

string (uri)

Der angeforderte Zielcontainer.

Bemerkungen

Wenn ein Zielcontainer in Kombination mit einem timeToLiveverwendet wird, werden die Metadaten einer Transkription normal gelöscht, aber die im Zielcontainer gespeicherten Daten, einschließlich Transkriptionsergebnissen, bleiben unverändert, da für diesen Container keine Löschberechtigungen erforderlich sind.
Um die automatische Bereinigung zu unterstützen, konfigurieren Sie entweder BLOB-Lebensdauern für den Container, oder verwenden Sie "Bring your own Storage (BYOS)" anstelle von destinationContainerUrl, wo Blobs bereinigt werden können.

diarization

DiarizationProperties

DiarizationProperties

diarizationEnabled

boolean

Ein Wert, der angibt, ob die Diarisierung (Sprecheridentifikation) angefordert wird. Der Standardwert ist false. Wenn dieses Feld auf "true" festgelegt ist und das verbesserte Diarisierungssystem durch Angabe von DiarizationPropertieskonfiguriert wird, stellt das verbesserte Diarisierungssystem Diarisierung für einen konfigurierbaren Bereich von Lautsprechern bereit. Wenn dieses Feld auf "true" festgelegt ist und das verbesserte Diarisierungssystem nicht aktiviert ist (nicht DiarizationPropertiesangeben), unterscheidet das grundlegende Diarisierungssystem zwischen bis zu zwei Lautsprechern. Für die Grundlegende Diarisierung werden keine zusätzlichen Gebühren erhoben.

Das grundlegende Diarisierungssystem ist veraltet und wird in der nächsten Hauptversion der API entfernt. Diese diarizationEnabled Einstellung wird ebenfalls entfernt.

displayFormWordLevelTimestampsEnabled

boolean

Ein Wert, der angibt, ob Zeitstempel der Wortebene für das Anzeigeformular angefordert werden. Der Standardwert ist false.

duration

string

Die Dauer der Transkription. Die Dauer wird als ISO 8601-Dauer codiert ("PnYnMnDTnHnMnS", siehe https://en.wikipedia.org/wiki/ISO_8601#Durations).

email

string

Die E-Mail-Adresse, an die E-Mail-Benachrichtigungen gesendet werden sollen, falls der Vorgang abgeschlossen ist. Der Wert wird nach dem erfolgreichen Senden der E-Mail entfernt.

error

EntityError

EntityError

languageIdentification

LanguageIdentificationProperties

LanguageIdentificationProperties

profanityFilterMode

ProfanityFilterMode

ProfanityFilterMode
Modus der Profanitätsfilterung.

punctuationMode

PunctuationMode

InterpunktionMode
Der modus, der für interpunktion verwendet wird.

timeToLive

string

Wie lange die Transkription im System aufbewahrt wird, nachdem sie abgeschlossen wurde. Sobald die Transkription die Zeit erreicht, um nach Abschluss (erfolgreich oder fehlgeschlagen) zu leben, wird sie automatisch gelöscht. Wenn Sie diesen Wert nicht festlegen oder auf 0 festlegen, wird das automatische Löschen deaktiviert. Die längste unterstützte Dauer beträgt 31 Tage. Die Dauer wird als ISO 8601-Dauer codiert ("PnYnMnDTnHnMnS", siehe https://en.wikipedia.org/wiki/ISO_8601#Durations).

wordLevelTimestampsEnabled

boolean

Ein Wert, der angibt, ob Zeitstempel der Wortebene angefordert werden. Der Standardwert ist false.