OpenSearch:Pengenalan suara

Daftar layanan

• Informasi otentikasi diperoleh.

  Saat memanggil layanan Platform Open AI Search menggunakan API, Anda perlu mengotentikasi identitas pemanggil.

• Alamat akses layanan diperoleh.

  Anda dapat memanggil layanan melalui Internet atau virtual private cloud (VPC). Untuk informasi lebih lanjut, lihat Dapatkan Alamat Pendaftaran Layanan.

Buat tugas pengenalan suara asinkron

Metode Permintaan: POST

URL

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

• host: Alamat untuk memanggil layanan. Anda dapat memanggil layanan API melalui Internet atau VPC. Untuk informasi lebih lanjut, lihat Dapatkan Alamat Pendaftaran Layanan.

• workspace_name: Nama ruang kerja, seperti default.

• service_id: ID layanan bawaan di sistem, seperti ops-audio-asr-001.

Parameter permintaan

Parameter header

Otentikasi API-KEY

Parameter body

input

output

Parameter respons

Contoh permintaan 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"
    }
  }' \ 

Respons sampel

{
  "request_id":"3eb8de02091b59431601f3bff******",
   "latency":37,
   "usage":{},
   "result":{
         "task_id":"asr-20250610164552-1108418170738252-******",
         "status":"PENDING"
             }
}

Dapatkan status tugas pengenalan suara asinkron

Metode Permintaan: GET

URL

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

• host: Alamat untuk memanggil layanan. Panggil layanan API melalui Internet atau VPC. Untuk informasi lebih lanjut, lihat Dapatkan Alamat Pendaftaran Layanan.

• workspace_name: Nama ruang kerja, seperti default.

• service_id: ID layanan bawaan di sistem, seperti ops-audio-asr-001.

• task_id: Pengidentifikasi tugas dalam parameter return dari pembuatan tugas pengenalan suara asinkron.

Parameter permintaan

Parameter respons

AsrResult

Contoh permintaan 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-******" 
 

Respons sampel

{
  "request_id": "1a1a4ca4b7a91dd630a40c54af******",
  "latency": 9,
  "usage": {
    "duration": 9
  },
  "result": {
    "task_id": "asr-20250618112151-1108418170738252-******",
    "status": "SUCCESS",
    "data": [
      {
        "text": "Rong Jielvdou mulai berbicara, suaranya sehangat matahari musim semi,",
        "start": 0.0,
        "end": 3.9
      },
      {
        "text": "penuh kehidupan dan menghangatkan hati semua orang yang mendengarkannya.",
        "start": 4.24,
        "end": 9.06
      }
    ]
  }
}

Buat tugas pengenalan suara sinkron

Metode Permintaan: POST

URL

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

• host: Alamat untuk memanggil layanan. Anda dapat memanggil layanan API melalui Internet atau VPC. Untuk informasi lebih lanjut, lihat Dapatkan Alamat Pendaftaran Layanan.

• workspace_name: Nama ruang kerja, seperti default.

• service_id: ID layanan bawaan di sistem, seperti ops-audio-asr-001.

Parameter permintaan

Parameter header

Otentikasi API-KEY

Parameter body

input

Output

Parameter respons

Contoh permintaan 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"
    }
  }' \ 

Respons sampel

{
  "request_id": "df96b5c444281e0e79561fe9f8******",
  "latency": 570,
  "usage": {
    "duration": 9
  },
  "result": {
    "task_id": "asr-20250618132401-1108418170738252-******",
    "status": "SUCCESS",
    "data": [
      {
        "text": "Rong Jielvdou mulai berbicara, suaranya sehangat matahari musim semi,",
        "start": 0.0,
        "end": 3.9
      },
      {
        "text": "penuh kehidupan dan menghangatkan hati semua orang yang mendengarkannya.",
        "start": 4.24,
        "end": 9.06
      }
    ]
  }
}

Deskripsi kode status

Dalam kasus kesalahan permintaan, hasil output akan menunjukkan alasan kesalahan melalui kode dan pesan.

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

Untuk informasi lebih lanjut tentang kode status, lihat Deskripsi Kode Status.