API調用說明

調用API時，參數配置如下：

• domain：nls-slp.cn-shanghai.aliyuncs.com

• version：2019-08-19

詳細調用示例代碼，請參見使用示例。

API詳情

CosyVoiceClone：提交聲音復刻任務

• 接口說明

  提交聲音復刻任務，需同時設置樣本音頻文件和生成音頻文件的前綴。

• 請求參數

  參數	類型	傳參方式	是否必選	描述
  Url	String	Body	是	樣本音頻文件地址，須確保公網可訪問。每次僅能上傳1個音頻，音頻格式要求： 聲道數：單聲道 采樣位數：16 bit 采樣率：大于22050 Hz 格式：WAV、MP3、M4A 時長：5秒~20秒
  VoicePrefix	String	Body	是	生成音頻名稱的前綴，例如：tongyi。

  請求示例：

  {
      "Url": "http://****.oss-cn-hangzhou.aliyuncs.com/linjing/voicegen/dataset/Musk.wav?OSSAccessKeyId=LTAI5t8W15Y4eALUtgsu****&Expires=3601716441689&Signature=1JLsNxGoGkJE1XTpRJu7yIow4aw%3D",
      "VoicePrefix": "tongyi"
  }

• 返回參數

  參數	類型	描述
  RequestId	String	請求ID。
  Code	Integer	狀態碼。
  Message	String	錯誤信息。
  VoiceName	String	生成音頻的名稱，命名格式：cosyvoice-${voice_prefix}-${7位隨機字符}。其中，${voice_prefix}即請求參數中設置的音頻名稱前綴。

  返回示例：

  {
      "RequestId": "A3136B58-5876-4168-83CA-B5627819****",
      "Code": 20000000,
      "Message": "SUCCESS",
      "VoiceName": "cosyvoice-tongyi-90fa79f"
  }

ListCosyVoice：查詢指定音頻名稱前綴的所有聲音

• 接口說明

  查詢指定音頻名稱前綴的所有聲音，可分頁展示。

• 請求參數

  參數	類型	傳參方式	是否必選	描述
  VoicePrefix	String	Body	是	待查詢音頻名稱的前綴，例如：tongyi。
  PageSize	Integer	Body	否	頁大小，默認值：10。
  PageIndex	Integer	Body	否	頁序號，默認值：1。

  請求示例：

  {
      "VoicePrefix": "tongyi"
  }

• 返回參數

  參數	類型	描述
  RequestId	String	請求ID。
  Code	Integer	狀態碼。
  Message	String	錯誤信息。
  PageIndex	Integer	當前展示頁序號。
  PageSize	Integer	當前展示頁大小。
  TotalCount	Integer	當前音頻名稱前綴下所有聲音的數量。
  Voices	List	聲音列表。
  Voices[i].VoiceName	String	音頻名稱。
  Voices[i].Status	String	聲音復刻狀態。
  Voices[i].StatusDesc	String	聲音復刻狀態描述。
  Voices[i].GmtCreate	String	聲音復刻任務創建時間，例如：2024-06-14 16:20:42。

  返回示例：

  {
      "TotalCount": 1,
      "RequestId": "C623E918-1C7E-137F-BDFE-6E872107****",
      "Message": "SUCCESS",
      "PageSize": 10,
      "PageIndex": 1,
      "Code": 20000000,
      "Voices": [
          {
              "Status": "SUCCESS",
              "StatusDesc": "復刻成功",
              "GmtCreate": "2024-06-14 16:20:42",
              "VoiceName": "cosyvoice-tongyi-0a9a15e"
          }
      ]
  }