文件

# AI Music_歌聲生成(Beta-v2)

Service: https://arts.api.yating.tw/v1

輸入文字prompt,AI幫你產生音樂。


發起請求

Request

URL: /textToMusic
Method: POST

Header

Name Type Info
*key String
*Content-Type String Only “application/json”

Body

Name Type Info
*text string English
*config JSON length: integer in sec, up to 12
{
   "text": "guitar solo, bossa nova, C minor, bpm 100",
   "config":{
      "length":60 
   }
}

Response

[
   {
       "uid": "313fb766-cf44-421c-b818-6127ed91d739",
       "status": "pending",
       "createdAt": "2022-08-26T11:40:42.401Z",
       "updatedAt": "2022-08-26T11:40:42.401Z"
   }
]

處理狀態查詢

進行處理後,“狀態”鍵將從“待處理”變為“處理中”,最後變為“完成”。 如果出現問題,就會進入“錯誤”。 您可以發出 GET 請求,如下所示,以檢查轉錄狀態的更新。

您必須重複 GET 請求,直到您的狀態為“完成”或“錯誤”。 一旦狀態鍵顯示為“已完成”,您就可以從 audioUrl 拿到新的連結,並且可以直接下載檔案。

Request

URL: /textToMusic?page=1&perPage=10&status=pending
Method: GET

Header

Name Type Info
*key String Bearer {key}

Response

Name Type Info
id object status: Pending, Completed, processing, Error, Expired, Not exists

expiredAt: RFC3339 timestamp
{
  "page":2,
  "perPage":10,
  "total":21,
  "nextPage":3,
  "data":[
    {
      "uid":"512b978b-3bda-4f01-aeca-a5abc1944cc2",
      "taskId":"74fb6122-af46-4578-acd1-eb25aac8a893",
      "status":"ongoing",
      "createdAt":"2022-11-22T16:49:25.835Z",
      "updatedAt":"2022-11-22T16:49:35.000Z"
      "text": "guitar solo, bossa nova, C minor, bpm 100",
      "config":{
        "length":60
      },
      "audioUrl": "xxxx"
    }
  ]
}

取得音檔結果

只要你的音檔狀態是 completed,你即可從以下 audioUrl 中取得處理後的音檔連結,並進行下載。

Request

URL: /textToMusic/{uid}
Method: GET

Header

Name Type Info
*key String Bearer {key}

Query parameter

Name Info
{uid} string,uid.

Response

{
   "uid":"313fb766-cf44-421c-b818-6127ed91d739",
   "status":"success",
   "text": "guitar solo, bossa nova, C minor, bpm 100",
   "config":{
      "length":60
   },
   "audioUrl": "xxxx"
}