Beispiel für Basisanforderung

Im folgenden Beispiel wird eine Erkennungsanforderung für eine einzelne FLAC-Datei mit dem Namen audio-file.flac gesendet. In der Anforderung ist der Abfrageparameter model nicht angegeben, damit das Standardsprachmodell en-US_BroadbandModel verwendet wird. Weitere Informationen finden Sie unter "Verwendung des Standardmodells ".

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
--header "Content-Type: audio/flac" \
--data-binary @{path}audio-file.flac \
"{url}/v1/recognize"

IBM Cloud Pak for Data IBM Software Hub

curl -X POST \
--header "Authorization: Bearer {token}" \
--header "Content-Type: audio/flac" \
--data-binary @{path}audio-file.flac \
"{url}/v1/recognize"

Im Beispiel wird für die Audiodaten die folgende Transkription zurückgegeben:

{
  "result_index": 0,
  "results": [
    {
      "alternatives": [
        {
          "confidence": 0.96,
          "transcript": "several tornadoes touch down as a line of severe thunderstorms swept through Colorado on Sunday "
        }
      ],
      "final": true
    }
  ]
}

Parameter für mehrteilige Anforderungen

Sie geben eine Reihe von Parametern als Formulardaten, Anforderungsheader oder Abfrageparameter an. Weitere Informationen zu Anforderungsheadern und Abfrageparametern enthält der Abschnitt Parameterübersicht.

JSON-Metadaten für mehrteilige Anforderungen

Die JSON-Metadaten, die Sie mit einer mehrteiligen Anforderung übergeben, können die folgenden Felder enthalten:

• part_content_type (Zeichenfolge)
• data_parts_count (Ganzzahl)
• customization_weight (Zahl)
• inactivity_timeout (Ganzzahl)
• keywords (Zeichenfolge[])
• keywords_threshold (Zahl)
• max_alternatives (Ganzzahl)
• word_alternatives_threshold (Zahl)
• word_confidence(Boolesch)
• timestamps(Boolesch)
• profanity_filter(Boolesch)
• smart_formatting(Boolesch)
• speaker_labels(Boolesch)
• grammar_name (Zeichenfolge)
• redaction(Boolesch)
• end_of_phrase_silence_time (Doppelzeichen)
• split_transcript_at_phrase_end(Boolesch)
• speech_detector_sensitivity (Zahl)
• background_audio_suppression (Zahl)
• low_latency(Boolesch)
• character_insertion_bias (Gleitkomma)

Nur die beiden folgenden Parameter sind speziell für mehrteilige Anforderungen vorgesehen:

• Das Feld part_content_type ist bei den meisten Audioformaten optional. Er ist jedoch erforderlich für die Formate audio/alaw, audio/basic, audio/l16 und audio/mulaw. Es gibt das Format der Audiodaten in den anschließenden Teilen der Anforderung an. Alle Audiodateien müssen dasselbe Format besitzen.
• Das Feld data_parts_count ist bei allen Anforderungen optional. Es gibt die Anzahl der Audiodateien an, die mit der Anforderung gesendet werden. Der Service wendet die Datenstromendeerkennung auf den letzten (und möglicherweise einzigen) Datenteil an. Falls Sie den Parameter weglassen, ermittelt der Service die Anzahl der Teile aus der Anforderung.

Alle anderen Parameter der Metadaten sind optional. Eine Beschreibung aller verfügbaren Parameter finden Sie in der Parameterübersicht.

Beispiel für mehrteilige Anforderung

Das folgende Beispiel zeigt, wie eine mehrteilige Erkennungsanforderung mit der Methode POST /v1/recognize übergeben wird. Die Anforderung übergibt zwei Audiodateien namens audio-file1.flac und audio-file2.flac. Der Parameter metadata stellt die meisten Parameter für die Anforderung zur Verfügung. Die Parameter upload stellen die Audiodateien zur Verfügung.

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
--header "Content-Type: multipart/form-data" \
--form metadata="{\"part_content_type\":\"application/octet-stream\", \
  \"data_parts_count\":2, \
  \"timestamps\":true, \
  \"word_alternatives_threshold\":0.9, \
  \"keywords\":[\"colorado\",\"tornado\",\"tornadoes\"], \
  \"keywords_threshold\":0.5}" \
--form upload="@{path}audio-file1.flac" \
--form upload="@{path}audio-file2.flac" \
"{url}/v1/recognize"

IBM Cloud Pak for Data IBM Software Hub

curl -X POST \
--header "Authorization: Bearer {token}" \
--header "Content-Type: multipart/form-data" \
--form metadata="{\"part_content_type\":\"application/octet-stream\", \
  \"data_parts_count\":2, \
  \"timestamps\":true, \
  \"word_alternatives_threshold\":0.9, \
  \"keywords\":[\"colorado\",\"tornado\",\"tornadoes\"], \
  \"keywords_threshold\":0.5}" \
--form upload="@{path}audio-file1.flac" \
--form upload="@{path}audio-file2.flac" \
"{url}/v1/recognize"

Im Beispiel wird für die Audiodaten die folgende Transkription zurückgegeben. Der Service gibt die Ergebnisse für die beiden Dateien in der Reihenfolge zurück, in der sie gesendet wurden. (In der Beispielausgabe sind die Ergebnisse für die zweite Datei abgekürzt.)

{
  "result_index": 0,
  "results": [
    {
      "word_alternatives": [
        {
          "start_time": 0.03,
          "alternatives": [
            {
              "confidence": 0.96,
              "word": "the"
            }
          ],
          "end_time": 0.09
        },
        {
          "start_time": 0.09,
          "alternatives": [
            {
              "confidence": 0.96,
              "word": "latest"
            }
          ],
          "end_time": 0.62
        },
        {
          "start_time": 0.62,
          "alternatives": [
            {
              "confidence": 0.96,
              "word": "weather"
            }
          ],
          "end_time": 0.87
        },
        {
          "start_time": 0.87,
          "alternatives": [
            {
              "confidence": 0.96,
              "word": "report"
            }
          ],
          "end_time": 1.5
        }
      ],
      "keywords_result": {},
      "alternatives": [
        {
          "timestamps": [
            [
              "the",
              0.03,
              0.09
            ],
            [
              "latest",
              0.09,
              0.62
            ],
            [
              "weather",
              0.62,
              0.87
            ],
            [
              "report",
              0.87,
              1.5
            ]
          ],
          "confidence": 0.99,
          "transcript": "the latest weather report "
        }
      ],
      "final": true
    },
    {
      "word_alternatives": [
        {
          "start_time": 0.15,
          "alternatives": [
            {
              "confidence": 1.0,
              "word": "a"
            }
          ],
          "end_time": 0.3
        },
        {
          "start_time": 0.3,
          "alternatives": [
            {
              "confidence": 1.0,
              "word": "line"
            }
          ],
          "end_time": 0.64
        },
        . . .
        {
          "start_time": 4.58,
          "alternatives": [
            {
              "confidence": 0.98,
              "word": "Colorado"
            }
          ],
          "end_time": 5.16
        },
        {
          "start_time": 5.16,
          "alternatives": [
            {
              "confidence": 0.98,
              "word": "on"
            }
          ],
          "end_time": 5.32
        },
        {
          "start_time": 5.32,
          "alternatives": [
            {
              "confidence": 0.98,
              "word": "Sunday"
            }
          ],
          "end_time": 6.04
        }
      ],
      "keywords_result": {
        "tornadoes": [
          {
            "normalized_text": "tornadoes",
            "start_time": 3.03,
            "confidence": 0.98,
            "end_time": 3.84
          }
        ],
        "colorado": [
          {
            "normalized_text": "Colorado",
            "start_time": 4.58,
            "confidence": 0.98,
            "end_time": 5.16
          }
        ]
      },
      "alternatives": [
        {
          "timestamps": [
            [
              "a",
              0.15,
              0.3
            ],
            [
              "line",
              0.3,
              0.64
            ],
            . . .
            [
              "Colorado",
              4.58,
              5.16
            ],
            [
              "on",
              5.16,
              5.32
            ],
            [
              "Sunday",
              5.32,
              6.04
            ]
          ],
          "confidence": 0.99,
          "transcript": "a line of severe thunderstorms with several
possible tornadoes is approaching Colorado on Sunday "
        }
      ],
      "final": true
    }
  ]
}