OpenSearch:音声認識

サービス一覧

• 認証情報を取得します。

  API を使用して AI Search Open Platform サービスを呼び出す場合は、呼び出し元の ID を認証する必要があります。

• サービスアクセスアドレスを取得します。

  インターネットまたは VPC (仮想プライベートクラウド) を介してサービスを呼び出すことができます。詳細については、「サービス登録アドレスを取得する」をご参照ください。

非同期音声認識タスクを作成する

リクエストメソッド: POST

URL

POST {host}/v3/openapi/workspaces/{workspace_name}/audio-asr/{service_id}/async 

• host: サービスを呼び出すためのアドレス。インターネットまたは VPC を介して API サービスを呼び出すことができます。詳細については、「サービス登録アドレスを取得する」をご参照ください。

• workspace_name: ワークスペースの名前 (例: default)。

• service_id: システムに組み込まれているサービス ID (例: ops-audio-asr-001)。

リクエストパラメーター

ヘッダーパラメーター

API-KEY 認証

ボディパラメーター

input

output

レスポンスパラメーター

Curl リクエストの例

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <Your API-KEY>" \
  "http://***-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/audio-asr/ops-audio-asr-001/async"
  --data '{
  "input":{
      "oss":"oss://<BUCKET_NAME>/xxx/xxx.mp3",
      "file_name":"xxx"
    },
    "output" :{
      "type":"oss",
      "oss":"oss://<BUCKET_NAME>/result"
    }
  }' \ 

レスポンスの例

{
  "request_id":"3eb8de02091b59431601f3bff******",
   "latency":37,
   "usage":{},
   "result":{
         "task_id":"asr-20250610164552-1108418170738252-******",
         "status":"PENDING"  // ペンディング
             }
}

非同期音声認識タスクのステータスを取得する

リクエストメソッド: GET

URL

{host}/v3/openapi/workspaces/{workspace_name}/audio-asr/{service_id}/async/task-status?task_id={task_id}

• host: サービスを呼び出すためのアドレス。インターネットまたは VPC を介して API サービスを呼び出します。詳細については、「サービス登録アドレスを取得する」をご参照ください。

• workspace_name: ワークスペースの名前 (例: default)。

• service_id: システムに組み込まれているサービス ID (例: ops-audio-asr-001)。

• task_id: 非同期音声認識タスクの作成の戻りパラメーターにあるタスク識別子。

リクエストパラメーター

レスポンスパラメーター

AsrResult

Curl リクエストの例

curl -X GET \
-H"Content-Type: application/json" \
-H "Authorization: Bearer <Your API-KEY>" \
"http://***-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/audio-asr/ops-audio-asr-001/async/task-status?task_id=asr-20250618112151-1108418170738252-******" 
 

レスポンスの例

{
  "request_id": "1a1a4ca4b7a91dd630a40c54af******",
  "latency": 9,
  "usage": {
    "duration": 9
  },
  "result": {
    "task_id": "asr-20250618112151-1108418170738252-******",
    "status": "SUCCESS",
    "data": [
      {
        "text": "Rong Jielvdou began to speak, his voice as warm as the spring sun,", // ロン・ジエルブドウが話し始め、彼の声は春の太陽のように暖かく、
        "start": 0.0,
        "end": 3.9
      },
      {
        "text": "full of life and warming the hearts of everyone who listened.", // 生気に満ち、聞いた人すべての心を温めました。
        "start": 4.24,
        "end": 9.06
      }
    ]
  }
}

同期音声認識タスクを作成する

リクエストメソッド: POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/audio-asr/{service_id}/sync

• host: サービスを呼び出すためのアドレス。インターネットまたは VPC を介して API サービスを呼び出すことができます。詳細については、「サービス登録アドレスを取得する」をご参照ください。

• workspace_name: ワークスペースの名前 (例: default)。

• service_id: システムに組み込まれているサービス ID (例: ops-audio-asr-001)。

リクエストパラメーター

ヘッダーパラメーター

API-KEY 認証

ボディパラメーター

input

Output

レスポンスパラメーター

Curl リクエストの例

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <Your API-KEY>" \
  "http://***-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/audio-asr/ops-audio-asr-001/sync"
  --data '{
  "input":{
      "oss":"oss://<BUCKET_NAME>/xxx/xxx.mp3",
      "file_name":"xxx"
    },
    "output" :{
      "type":"oss",
      "oss":"oss://<BUCKET_NAME>/result"
    }
  }' \ 

レスポンスの例

{
  "request_id": "df96b5c444281e0e79561fe9f8******",
  "latency": 570,
  "usage": {
    "duration": 9
  },
  "result": {
    "task_id": "asr-20250618132401-1108418170738252-******",
    "status": "SUCCESS",
    "data": [
      {
        "text": "Rong Jielvdou began to speak, his voice as warm as the spring sun,", // ロン・ジエルブドウが話し始め、彼の声は春の太陽のように暖かく、
        "start": 0.0,
        "end": 3.9
      },
      {
        "text": "full of life and warming the hearts of everyone who listened.", // 生気に満ち、聞いた人すべての心を温めました。
        "start": 4.24,
        "end": 9.06
      }
    ]
  }
}

状態コードの説明

リクエストエラーが発生した場合、出力結果には code と message によってエラーの理由が示されます。

{
    "request_id": "6F33AFB6-A35C-4DA7-AFD2-9EA16CCF****",
    "latency": 2.0,
    "code": "InvalidParameter", // 無効なパラメーター
    "http_code": 400,
    "message": "JSON parse error: Cannot deserialize value of type `ImageStorage` from String \\"xxx\\"" // JSON 解析エラー: 文字列 \\"xxx\\" から `ImageStorage` タイプの値を逆シリアル化できません
}

状態コードの詳細については、「状態コードの説明」をご参照ください。