基本要求の例

以下の例では、audio-file.flacという名前の単一 FLAC ファイルに対する認識要求を送信します。 この要求では model クエリー・パラメーターを省略して、デフォルト言語モデル en-US_BroadbandModel を使用しています。 詳細は 、「デフォルトモデルの使用 」を参照してください。

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"

上記の例では、対象の音声に対して次の書き起こし結果が返されます。

{
  "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
    }
  ]
}

マルチパート要求のパラメーター

いくつかのパラメーターを、フォーム・データ、要求ヘッダー、または照会パラメーターとして指定します。 要求ヘッダーおよび照会パラメーターについて詳しくは、パラメーターの要約を参照してください。

マルチパート要求の JSON メタデータ

マルチパート要求を通じて渡す JSON メタデータには、以下のフィールドを含めることができます。

• part_content_type (string)
• data_parts_count (integer)
• customization_weight (number)
• inactivity_timeout (integer)
• keywords (ストリング[])
• keywords_threshold (number)
• max_alternatives (integer)
• word_alternatives_threshold (number)
• word_confidence (boolean)
• timestamps (boolean)
• profanity_filter (boolean)
• smart_formatting (boolean)
• speaker_labels (boolean)
• grammar_name (string)
• redaction (boolean)
• end_of_phrase_silence_time (double)
• split_transcript_at_phrase_end (boolean)
• speech_detector_sensitivity (number)
• background_audio_suppression (number)
• low_latency (boolean)
• character_insertion_bias (浮動小数点)

マルチパート要求専用のパラメーターは以下の 2 つのみです。

• part_content_type フィールドは、ほとんどの音声フォーマットではオプション です。 このフィールドが必須となるフォーマットは、audio/alaw、 audio/basic、audio/l16、および audio/mulaw です。 このフィールドでは、要求の後続パート内の音声のフォーマットを指定します。 すべての音声ファイルは同じフォーマットである必要があります。
• data_parts_count フィールドは、すべての要求でオプション です。 このフィールドでは、その要求を通じて送信される音声ファイルの数を指定します。 サービスは、ストリーム終了検知を最後の (おそらく唯一の) データ・パートで実施します。 このパラメーターを省略すると、サービスによって要求からパートの数が判別されます。

メタデータの他のすべてのパラメーターはオプションです。 すべての使用可能なパラメーターについて詳しくは、パラメーターの要約を参照してください。

マルチパート要求の例

以下の例は、POST /v1/recognize メソッドを使用してマルチパート認識要求を渡す方法を示しています。 この要求によって、2 つの音声ファイル audio-file1.flac および audio-file2.flac を渡します。 metadata パラメーターでは、この要求のほとんどのパラメーターを指定し、upload パラメーターでは音声ファイルを指定します。

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"

上記の例では、指定された音声ファイルに対して次の書き起こし結果が返されます。 これら 2 つのファイルが送信された順序で、これらのファイルの結果が返されます (この例の出力では、2 つ目のファイルの結果を省略表記しています)。

{
  "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
    }
  ]
}