OpenAi-HK

English

简体中文

English

简体中文

Appearance

Suno Newapi Format ​

2024.10.29 Now compatible with Newapi format

  • Go to Channel -> Add Channel and configure as shown below

newapi

1. Generate Lyrics ​

post https://api.openai-hk.com/suno/submit/lyrics

shell
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/lyrics \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "乡愁"
}'
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/lyrics \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "乡愁"
}'

The data field in the response is the task task_id

json
{
  "code": "success",
  "data": "751c7248-5d1a-414e-9827-9d39e5533b33",
  "message": ""
}
{
  "code": "success",
  "data": "751c7248-5d1a-414e-9827-9d39e5533b33",
  "message": ""
}

2. Generate Music ​

post https://api.openai-hk.com/suno/submit/music

shell
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/music \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "gpt_description_prompt": "乡愁"
}'
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/music \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "gpt_description_prompt": "乡愁"
}'

a. Inspiration Mode ​

Request body

json
{
  "gpt_description_prompt": "乡愁"
}
{
  "gpt_description_prompt": "乡愁"
}

b. Custom Mode ​

Request body

json
{
  "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
  "tags": "emotional punk",
  "mv": "chirp-v3-5",
  "title": "City Lights"
}
{
  "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
  "tags": "emotional punk",
  "mv": "chirp-v3-5",
  "title": "City Lights"
}

c. Continue ​

Request body

json
{
  "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
  "tags": "bass-driven atmospheric heavy metal",
  "mv": "chirp-v3-5",
  "title": "City Lights",
  "continue_clip_id": "ce2cfbce-9ea0-45b0-9386-020c0ff54a49",
  "continue_at": 80
}
{
  "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
  "tags": "bass-driven atmospheric heavy metal",
  "mv": "chirp-v3-5",
  "title": "City Lights",
  "continue_clip_id": "ce2cfbce-9ea0-45b0-9386-020c0ff54a49",
  "continue_at": 80
}

D. More Modes ​

For more mode scenarios, please refer to Suno scene applications

Request Body Parameter Description ​

ParameterDescriptionTypeDefault
gpt_description_promptInspiration promptstring
mvModel, valid values: chirp-v3-0 chirp-v3-5stringchirp-v3-0
titleTitlestring
promptLyricsstring
tagsSong style, multiple styles separated by spacesstring
continue_atStart timeinteger(int64)
continue_clip_idID of the previous songstring

Music Response Body ​

The data field in the final response for all 3 modes above is the task task_id

json
{
  "code": "success",
  "data": "6e7dfb41-5a21-4189-8246-e2b6ae103ccd",
  "message": ""
}
{
  "code": "success",
  "data": "6e7dfb41-5a21-4189-8246-e2b6ae103ccd",
  "message": ""
}

3. Get Single Task ​

GET https://api.openai-hk.com/suno/fetch/{task_id}

Response body - Lyrics

shell
{
	"code": "success",
	"data": {
		"task_id": "24c35560-5d0a-470d-bd31-976d02d43926",
		"notify_hook": "",
		"action": "LYRICS",
		"status": "SUCCESS",
		"fail_reason": "",
		"submit_time": 1730209678,
		"start_time": 1730209678,
		"finish_time": 1730209687,
		"progress": "100%",
		"data": {
			"status": "complete",
			"text": "[Verse]\n骑着单车在海边漫游\n夕阳洒在我们的左右\n微风轻拂你的发梢\n你笑着说这一刻真好\n\n[Verse 2]\n我们在环岛路上追逐\n欢笑声比浪花还要酷\n沙滩上留下并肩脚印\n未来的梦在心里酝酿\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上\n\n[Verse 3]\n鼓浪屿的小巷中徘徊\n风琴声带我们走向未来\n古老建筑见证了时光\n我们牵手走在美丽天堂\n\n[Bridge]\n夜景灿烂如星光闪耀\n我们在这城市中狂跳\n厦门夜晚有如梦幻曲\n迷人风景永远让人迷\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上",
			"title": "厦门"
		}
	},
	"message": ""
}
{
	"code": "success",
	"data": {
		"task_id": "24c35560-5d0a-470d-bd31-976d02d43926",
		"notify_hook": "",
		"action": "LYRICS",
		"status": "SUCCESS",
		"fail_reason": "",
		"submit_time": 1730209678,
		"start_time": 1730209678,
		"finish_time": 1730209687,
		"progress": "100%",
		"data": {
			"status": "complete",
			"text": "[Verse]\n骑着单车在海边漫游\n夕阳洒在我们的左右\n微风轻拂你的发梢\n你笑着说这一刻真好\n\n[Verse 2]\n我们在环岛路上追逐\n欢笑声比浪花还要酷\n沙滩上留下并肩脚印\n未来的梦在心里酝酿\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上\n\n[Verse 3]\n鼓浪屿的小巷中徘徊\n风琴声带我们走向未来\n古老建筑见证了时光\n我们牵手走在美丽天堂\n\n[Bridge]\n夜景灿烂如星光闪耀\n我们在这城市中狂跳\n厦门夜晚有如梦幻曲\n迷人风景永远让人迷\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上",
			"title": "厦门"
		}
	},
	"message": ""
}

Response body - Music

json
{
  "code": "success",
  "data": {
    "task_id": "6e7dfb41-5a21-4189-8246-e2b6ae103ccd",
    "notify_hook": "",
    "action": "MUSIC",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1730208225,
    "start_time": 1730208225,
    "finish_time": 1730208257,
    "progress": "100%",
    "data": [
      {
        "audio_url": "https://cdn1.suno.ai/53db4a32-cb40-4412-8c1f-34409d2f3327.mp3",
        "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
        "created_at": "2024-10-29T13:23:44.841Z",
        "display_name": "DisconcertedBass2764",
        "handle": "disconcertedbass2764",
        "id": "53db4a32-cb40-4412-8c1f-34409d2f3327",
        "image_large_url": "https://cdn2.suno.ai/image_large_53db4a32-cb40-4412-8c1f-34409d2f3327.jpeg",
        "image_url": "https://cdn2.suno.ai/image_53db4a32-cb40-4412-8c1f-34409d2f3327.jpeg",
        "is_handle_updated": false,
        "is_liked": false,
        "is_public": false,
        "is_trashed": false,
        "is_video_pending": true,
        "major_model_version": "v3",
        "metadata": {
          "duration": 64.36,
          "gpt_description_prompt": "天津",
          "prompt": "[Verse]\nOn the streets of Tianjin we dance in the rain\nLife's a wild river nothing to tame\nNeon lights flash hearts beat out loud\nIn the city of dreams we stand so proud\n\n[Bridge]\nFrom the markets to the river's bend\nStories of old and new blend\nEchoes of laughter fill the night\nTianjin's magic burning bright\n\n[Chorus]\nOh Tianjin you light up my soul\nEvery alley every goal\nIn your arms I find my way\nIn your embrace I want to stay",
          "refund_credits": false,
          "stream": true,
          "tags": "pop lively",
          "type": "gen"
        },
        "model_name": "chirp-v3",
        "play_count": 0,
        "status": "complete",
        "title": "天津",
        "upvote_count": 0,
        "video_url": "https://cdn1.suno.ai/53db4a32-cb40-4412-8c1f-34409d2f3327.mp4"
      },
      {
        "audio_url": "https://cdn1.suno.ai/94241e2d-7e50-44db-9b7e-e6ca656894c1.mp3",
        "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
        "created_at": "2024-10-29T13:23:44.841Z",
        "display_name": "DisconcertedBass2764",
        "handle": "disconcertedbass2764",
        "id": "94241e2d-7e50-44db-9b7e-e6ca656894c1",
        "image_large_url": "https://cdn2.suno.ai/image_large_94241e2d-7e50-44db-9b7e-e6ca656894c1.jpeg",
        "image_url": "https://cdn2.suno.ai/image_94241e2d-7e50-44db-9b7e-e6ca656894c1.jpeg",
        "is_handle_updated": false,
        "is_liked": false,
        "is_public": false,
        "is_trashed": false,
        "is_video_pending": true,
        "major_model_version": "v3",
        "metadata": {
          "duration": 74.68,
          "gpt_description_prompt": "天津",
          "prompt": "[Verse]\nOn the streets of Tianjin we dance in the rain\nLife's a wild river nothing to tame\nNeon lights flash hearts beat out loud\nIn the city of dreams we stand so proud\n\n[Bridge]\nFrom the markets to the river's bend\nStories of old and new blend\nEchoes of laughter fill the night\nTianjin's magic burning bright\n\n[Chorus]\nOh Tianjin you light up my soul\nEvery alley every goal\nIn your arms I find my way\nIn your embrace I want to stay",
          "refund_credits": false,
          "stream": true,
          "tags": "pop lively",
          "type": "gen"
        },
        "model_name": "chirp-v3",
        "play_count": 0,
        "status": "complete",
        "title": "天津",
        "upvote_count": 0,
        "video_url": "https://cdn1.suno.ai/94241e2d-7e50-44db-9b7e-e6ca656894c1.mp4"
      }
    ]
  },
  "message": ""
}
{
  "code": "success",
  "data": {
    "task_id": "6e7dfb41-5a21-4189-8246-e2b6ae103ccd",
    "notify_hook": "",
    "action": "MUSIC",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1730208225,
    "start_time": 1730208225,
    "finish_time": 1730208257,
    "progress": "100%",
    "data": [
      {
        "audio_url": "https://cdn1.suno.ai/53db4a32-cb40-4412-8c1f-34409d2f3327.mp3",
        "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
        "created_at": "2024-10-29T13:23:44.841Z",
        "display_name": "DisconcertedBass2764",
        "handle": "disconcertedbass2764",
        "id": "53db4a32-cb40-4412-8c1f-34409d2f3327",
        "image_large_url": "https://cdn2.suno.ai/image_large_53db4a32-cb40-4412-8c1f-34409d2f3327.jpeg",
        "image_url": "https://cdn2.suno.ai/image_53db4a32-cb40-4412-8c1f-34409d2f3327.jpeg",
        "is_handle_updated": false,
        "is_liked": false,
        "is_public": false,
        "is_trashed": false,
        "is_video_pending": true,
        "major_model_version": "v3",
        "metadata": {
          "duration": 64.36,
          "gpt_description_prompt": "天津",
          "prompt": "[Verse]\nOn the streets of Tianjin we dance in the rain\nLife's a wild river nothing to tame\nNeon lights flash hearts beat out loud\nIn the city of dreams we stand so proud\n\n[Bridge]\nFrom the markets to the river's bend\nStories of old and new blend\nEchoes of laughter fill the night\nTianjin's magic burning bright\n\n[Chorus]\nOh Tianjin you light up my soul\nEvery alley every goal\nIn your arms I find my way\nIn your embrace I want to stay",
          "refund_credits": false,
          "stream": true,
          "tags": "pop lively",
          "type": "gen"
        },
        "model_name": "chirp-v3",
        "play_count": 0,
        "status": "complete",
        "title": "天津",
        "upvote_count": 0,
        "video_url": "https://cdn1.suno.ai/53db4a32-cb40-4412-8c1f-34409d2f3327.mp4"
      },
      {
        "audio_url": "https://cdn1.suno.ai/94241e2d-7e50-44db-9b7e-e6ca656894c1.mp3",
        "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
        "created_at": "2024-10-29T13:23:44.841Z",
        "display_name": "DisconcertedBass2764",
        "handle": "disconcertedbass2764",
        "id": "94241e2d-7e50-44db-9b7e-e6ca656894c1",
        "image_large_url": "https://cdn2.suno.ai/image_large_94241e2d-7e50-44db-9b7e-e6ca656894c1.jpeg",
        "image_url": "https://cdn2.suno.ai/image_94241e2d-7e50-44db-9b7e-e6ca656894c1.jpeg",
        "is_handle_updated": false,
        "is_liked": false,
        "is_public": false,
        "is_trashed": false,
        "is_video_pending": true,
        "major_model_version": "v3",
        "metadata": {
          "duration": 74.68,
          "gpt_description_prompt": "天津",
          "prompt": "[Verse]\nOn the streets of Tianjin we dance in the rain\nLife's a wild river nothing to tame\nNeon lights flash hearts beat out loud\nIn the city of dreams we stand so proud\n\n[Bridge]\nFrom the markets to the river's bend\nStories of old and new blend\nEchoes of laughter fill the night\nTianjin's magic burning bright\n\n[Chorus]\nOh Tianjin you light up my soul\nEvery alley every goal\nIn your arms I find my way\nIn your embrace I want to stay",
          "refund_credits": false,
          "stream": true,
          "tags": "pop lively",
          "type": "gen"
        },
        "model_name": "chirp-v3",
        "play_count": 0,
        "status": "complete",
        "title": "天津",
        "upvote_count": 0,
        "video_url": "https://cdn1.suno.ai/94241e2d-7e50-44db-9b7e-e6ca656894c1.mp4"
      }
    ]
  },
  "message": ""
}

4. Get Batch Tasks ​

post https://api.openai-hk.com/suno/fetch

shell
curl --request POST \
  --url https://api.openai-hk.com/suno/fetch \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": [
    "57eb2c03-5d86-467b-b0df-cd08ce607e9d",
    "24c35560-5d0a-470d-bd31-976d02d43926"
  ]
}'
curl --request POST \
  --url https://api.openai-hk.com/suno/fetch \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": [
    "57eb2c03-5d86-467b-b0df-cd08ce607e9d",
    "24c35560-5d0a-470d-bd31-976d02d43926"
  ]
}'

Request body

json
{
  "ids": [
    "57eb2c03-5d86-467b-b0df-cd08ce607e9d",
    "24c35560-5d0a-470d-bd31-976d02d43926"
  ]
}
{
  "ids": [
    "57eb2c03-5d86-467b-b0df-cd08ce607e9d",
    "24c35560-5d0a-470d-bd31-976d02d43926"
  ]
}

Response body

json
{
  "code": "success",
  "data": [
    {
      "task_id": "57eb2c03-5d86-467b-b0df-cd08ce607e9d",
      "notify_hook": "",
      "action": "MUSIC",
      "status": "SUCCESS",
      "fail_reason": "",
      "submit_time": 1730178099,
      "start_time": 1730178099,
      "finish_time": 1730178141,
      "progress": "100%",
      "data": [
        {
          "audio_url": "https://cdn1.suno.ai/685346a2-e4d7-43f8-9daa-73bd110d84f0.mp3",
          "avatar_image_url": "https://cdn1.suno.ai/defaultBlue.webp",
          "created_at": "2024-10-29T05:01:39.098Z",
          "display_name": "DisconcertedOctet6941",
          "handle": "disconcertedoctet6941",
          "id": "685346a2-e4d7-43f8-9daa-73bd110d84f0",
          "image_large_url": "https://cdn2.suno.ai/image_large_685346a2-e4d7-43f8-9daa-73bd110d84f0.jpeg",
          "image_url": "https://cdn2.suno.ai/image_685346a2-e4d7-43f8-9daa-73bd110d84f0.jpeg",
          "is_handle_updated": false,
          "is_liked": false,
          "is_public": false,
          "is_trashed": false,
          "is_video_pending": false,
          "major_model_version": "v3",
          "metadata": {
            "duration": 79.84,
            "gpt_description_prompt": "天津",
            "prompt": "[Verse]\nMidnight lights in 天津 glow\nStreet vendors shout they steal the show\nRiver hugs the city close\nHarmony here it overflows\n\n[Bridge]\nTemples stand time whispers old\nStories in the walls unfold\nTanghulu sticks and laughter greet\n天津 rhythm in every beat\n\n[Chorus]\nOh oh oh 天津 riding through the nights\nOh oh oh feel the city's lights\nOh oh oh 天津 dancing in the breeze\nOh oh oh city's got me feeling free",
            "refund_credits": false,
            "stream": true,
            "tags": "pop vibrant",
            "type": "gen"
          },
          "model_name": "chirp-v3",
          "play_count": 0,
          "status": "complete",
          "title": "天津",
          "upvote_count": 0,
          "video_url": "https://cdn1.suno.ai/685346a2-e4d7-43f8-9daa-73bd110d84f0.mp4"
        },
        {
          "audio_url": "https://cdn1.suno.ai/8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.mp3",
          "avatar_image_url": "https://cdn1.suno.ai/defaultBlue.webp",
          "created_at": "2024-10-29T05:01:39.098Z",
          "display_name": "DisconcertedOctet6941",
          "handle": "disconcertedoctet6941",
          "id": "8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6",
          "image_large_url": "https://cdn2.suno.ai/image_large_8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.jpeg",
          "image_url": "https://cdn2.suno.ai/image_8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.jpeg",
          "is_handle_updated": false,
          "is_liked": false,
          "is_public": false,
          "is_trashed": false,
          "is_video_pending": false,
          "major_model_version": "v3",
          "metadata": {
            "duration": 71,
            "gpt_description_prompt": "天津",
            "prompt": "[Verse]\nMidnight lights in 天津 glow\nStreet vendors shout they steal the show\nRiver hugs the city close\nHarmony here it overflows\n\n[Bridge]\nTemples stand time whispers old\nStories in the walls unfold\nTanghulu sticks and laughter greet\n天津 rhythm in every beat\n\n[Chorus]\nOh oh oh 天津 riding through the nights\nOh oh oh feel the city's lights\nOh oh oh 天津 dancing in the breeze\nOh oh oh city's got me feeling free",
            "refund_credits": false,
            "stream": true,
            "tags": "pop vibrant",
            "type": "gen"
          },
          "model_name": "chirp-v3",
          "play_count": 0,
          "status": "complete",
          "title": "天津",
          "upvote_count": 0,
          "video_url": "https://cdn1.suno.ai/8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.mp4"
        }
      ]
    },
    {
      "task_id": "24c35560-5d0a-470d-bd31-976d02d43926",
      "notify_hook": "",
      "action": "LYRICS",
      "status": "SUCCESS",
      "fail_reason": "",
      "submit_time": 1730209678,
      "start_time": 1730209678,
      "finish_time": 1730209687,
      "progress": "100%",
      "data": {
        "status": "complete",
        "text": "[Verse]\n骑着单车在海边漫游\n夕阳洒在我们的左右\n微风轻拂你的发梢\n你笑着说这一刻真好\n\n[Verse 2]\n我们在环岛路上追逐\n欢笑声比浪花还要酷\n沙滩上留下并肩脚印\n未来的梦在心里酝酿\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上\n\n[Verse 3]\n鼓浪屿的小巷中徘徊\n风琴声带我们走向未来\n古老建筑见证了时光\n我们牵手走在美丽天堂\n\n[Bridge]\n夜景灿烂如星光闪耀\n我们在这城市中狂跳\n厦门夜晚有如梦幻曲\n迷人风景永远让人迷\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上",
        "title": "厦门"
      }
    }
  ],
  "message": ""
}
{
  "code": "success",
  "data": [
    {
      "task_id": "57eb2c03-5d86-467b-b0df-cd08ce607e9d",
      "notify_hook": "",
      "action": "MUSIC",
      "status": "SUCCESS",
      "fail_reason": "",
      "submit_time": 1730178099,
      "start_time": 1730178099,
      "finish_time": 1730178141,
      "progress": "100%",
      "data": [
        {
          "audio_url": "https://cdn1.suno.ai/685346a2-e4d7-43f8-9daa-73bd110d84f0.mp3",
          "avatar_image_url": "https://cdn1.suno.ai/defaultBlue.webp",
          "created_at": "2024-10-29T05:01:39.098Z",
          "display_name": "DisconcertedOctet6941",
          "handle": "disconcertedoctet6941",
          "id": "685346a2-e4d7-43f8-9daa-73bd110d84f0",
          "image_large_url": "https://cdn2.suno.ai/image_large_685346a2-e4d7-43f8-9daa-73bd110d84f0.jpeg",
          "image_url": "https://cdn2.suno.ai/image_685346a2-e4d7-43f8-9daa-73bd110d84f0.jpeg",
          "is_handle_updated": false,
          "is_liked": false,
          "is_public": false,
          "is_trashed": false,
          "is_video_pending": false,
          "major_model_version": "v3",
          "metadata": {
            "duration": 79.84,
            "gpt_description_prompt": "天津",
            "prompt": "[Verse]\nMidnight lights in 天津 glow\nStreet vendors shout they steal the show\nRiver hugs the city close\nHarmony here it overflows\n\n[Bridge]\nTemples stand time whispers old\nStories in the walls unfold\nTanghulu sticks and laughter greet\n天津 rhythm in every beat\n\n[Chorus]\nOh oh oh 天津 riding through the nights\nOh oh oh feel the city's lights\nOh oh oh 天津 dancing in the breeze\nOh oh oh city's got me feeling free",
            "refund_credits": false,
            "stream": true,
            "tags": "pop vibrant",
            "type": "gen"
          },
          "model_name": "chirp-v3",
          "play_count": 0,
          "status": "complete",
          "title": "天津",
          "upvote_count": 0,
          "video_url": "https://cdn1.suno.ai/685346a2-e4d7-43f8-9daa-73bd110d84f0.mp4"
        },
        {
          "audio_url": "https://cdn1.suno.ai/8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.mp3",
          "avatar_image_url": "https://cdn1.suno.ai/defaultBlue.webp",
          "created_at": "2024-10-29T05:01:39.098Z",
          "display_name": "DisconcertedOctet6941",
          "handle": "disconcertedoctet6941",
          "id": "8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6",
          "image_large_url": "https://cdn2.suno.ai/image_large_8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.jpeg",
          "image_url": "https://cdn2.suno.ai/image_8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.jpeg",
          "is_handle_updated": false,
          "is_liked": false,
          "is_public": false,
          "is_trashed": false,
          "is_video_pending": false,
          "major_model_version": "v3",
          "metadata": {
            "duration": 71,
            "gpt_description_prompt": "天津",
            "prompt": "[Verse]\nMidnight lights in 天津 glow\nStreet vendors shout they steal the show\nRiver hugs the city close\nHarmony here it overflows\n\n[Bridge]\nTemples stand time whispers old\nStories in the walls unfold\nTanghulu sticks and laughter greet\n天津 rhythm in every beat\n\n[Chorus]\nOh oh oh 天津 riding through the nights\nOh oh oh feel the city's lights\nOh oh oh 天津 dancing in the breeze\nOh oh oh city's got me feeling free",
            "refund_credits": false,
            "stream": true,
            "tags": "pop vibrant",
            "type": "gen"
          },
          "model_name": "chirp-v3",
          "play_count": 0,
          "status": "complete",
          "title": "天津",
          "upvote_count": 0,
          "video_url": "https://cdn1.suno.ai/8dbaa7e6-0b99-4f11-bee9-2b68718cb6d6.mp4"
        }
      ]
    },
    {
      "task_id": "24c35560-5d0a-470d-bd31-976d02d43926",
      "notify_hook": "",
      "action": "LYRICS",
      "status": "SUCCESS",
      "fail_reason": "",
      "submit_time": 1730209678,
      "start_time": 1730209678,
      "finish_time": 1730209687,
      "progress": "100%",
      "data": {
        "status": "complete",
        "text": "[Verse]\n骑着单车在海边漫游\n夕阳洒在我们的左右\n微风轻拂你的发梢\n你笑着说这一刻真好\n\n[Verse 2]\n我们在环岛路上追逐\n欢笑声比浪花还要酷\n沙滩上留下并肩脚印\n未来的梦在心里酝酿\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上\n\n[Verse 3]\n鼓浪屿的小巷中徘徊\n风琴声带我们走向未来\n古老建筑见证了时光\n我们牵手走在美丽天堂\n\n[Bridge]\n夜景灿烂如星光闪耀\n我们在这城市中狂跳\n厦门夜晚有如梦幻曲\n迷人风景永远让人迷\n\n[Chorus]\n厦门 厦门 我们的天堂\n每天都有幸福在发光\n四季花开如画的模样\n甜蜜记忆永远在心上",
        "title": "厦门"
      }
    }
  ],
  "message": ""
}

5. Song Concatenation ​

shell
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "a4715524-2d32-4ce3-a3dc-7e73d0705a98",
  "is_infill": false
}'
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "a4715524-2d32-4ce3-a3dc-7e73d0705a98",
  "is_infill": false
}'

Request body

json
{
  "clip_id": "a4715524-2d32-4ce3-a3dc-7e73d0705a98",
  "is_infill": false
}
{
  "clip_id": "a4715524-2d32-4ce3-a3dc-7e73d0705a98",
  "is_infill": false
}

The data field in the response is the task_id

json
{
  "code": "success",
  "data": "1ce1322a-3db0-467a-821a-2029d1e5186f",
  "message": ""
}
{
  "code": "success",
  "data": "1ce1322a-3db0-467a-821a-2029d1e5186f",
  "message": ""
}

6. Upload Audio ​

  • Only supports mp3
  • Resource-intensive, will deduct 200 credits

post https://api.openai-hk.com/sunoapi/uploads/audio-url

Request body

json
{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}
{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}

Response body

json
{
  "clip_id": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "code": "success",
  "data": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "message": ""
}
{
  "clip_id": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "code": "success",
  "data": "f4e624c0-b018-4933-8f35-be2bcc79a0c8",
  "message": ""
}
shell
curl --request POST \
  --url https://api.openai-hk.com/sunoapi/uploads/audio-url \
  --header 'Authorization: Bearer hk-yourKey' \
  --header 'content-type: application/json' \
  --data '{
	"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'
curl --request POST \
  --url https://api.openai-hk.com/sunoapi/uploads/audio-url \
  --header 'Authorization: Bearer hk-yourKey' \
  --header 'content-type: application/json' \
  --data '{
	"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'

7. Generate Lyrics V2 ​

7.1 Generate Lyrics Task ​

post https://api.openai-hk.com/suno/submit/lyrics

  • lyrics_model supports values remi-v1 and default
shell
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/lyrics \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "乡愁","lyrics_model": "remi-v1"
}'
curl --request POST \
  --url https://api.openai-hk.com/suno/submit/lyrics \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "乡愁","lyrics_model": "remi-v1"
}'

The data field in the response is the task task_id

json
{
  "code": "success",
  "data": "cd7181c5-0ee1-49d7-812d-a787aaabbc92",
  "lyrics_a_id": "bec05f47-cb1c-47d7-b29b-3c325140eee0",
  "lyrics_b_id": "aaa1ba24-c018-44c2-9625-59d30896bd51",
  "lyrics_request_id": "cd7181c5-0ee1-49d7-812d-a787aaabbc92",
  "message": ""
}
{
  "code": "success",
  "data": "cd7181c5-0ee1-49d7-812d-a787aaabbc92",
  "lyrics_a_id": "bec05f47-cb1c-47d7-b29b-3c325140eee0",
  "lyrics_b_id": "aaa1ba24-c018-44c2-9625-59d30896bd51",
  "lyrics_request_id": "cd7181c5-0ee1-49d7-812d-a787aaabbc92",
  "message": ""
}

7.2 Get Lyrics ​

get https://api.openai-hk.com/suno/fetch/cd7181c5-0ee1-49d7-812d-a787aaabbc92

Return result

  • data.action is the task LYRICS-V2
  • data.data[0].id is the task lyrics_a_id or lyrics_b_id
json
{
  "code": "success",
  "data": {
    "task_id": "cd7181c5-0ee1-49d7-812d-a787aaabbc92",
    "notify_hook": "",
    "action": "LYRICS-V2",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1763140449,
    "start_time": 1763140449,
    "finish_time": 1763140466,
    "progress": "100%",
    "search_item": "bec05f47-cb1c-47d7-b29b-3c325140eee0,aaa1ba24-c018-44c2-9625-59d30896bd51",
    "data": [
      {
        "clip_id": "bec05f47-cb1c-47d7-b29b-3c325140eee0",
        "error_message": "",
        "id": "bec05f47-cb1c-47d7-b29b-3c325140eee0",
        "status": "complete",
        "tags": ["relaxed", "atmospheric", "hip hop"],
        "text": "[Verse]\n有一天我若輕聲和你說再見\n只因我又聽到海浪聲\n那些貪婪的人不願相信\n唯有海洋才會包容\n那個無所不知的古老生物\n終有一天也會長眠\n\n[Pre-Chorus]\n而我親愛的\n我在你的懷中\n卻感覺像是\n[Chorus]\n啊 大海\n啊 大海",
        "title": "大海"
      },
      {
        "clip_id": "aaa1ba24-c018-44c2-9625-59d30896bd51",
        "error_message": "",
        "id": "aaa1ba24-c018-44c2-9625-59d30896bd51",
        "status": "complete",
        "tags": ["piano ballad", "slow", "heartfelt", "acoustic"],
        "text": "[Verse]\n從前的我沒學會眼淚\n還是個孩子\n也不曾疲倦\n在夢裡\n說要去遠方流浪\n直到夜裡\n靈魂還在遊蕩\n\n[Pre-Chorus]\n終於有一天\n\n[Chorus]\n我望著大海\n一片蔚藍\n讓靈魂從容地活\n平靜地死去\n天真與青春\n大海會接納我們",
        "title": "大海"
      }
    ]
  },
  "message": ""
}
{
  "code": "success",
  "data": {
    "task_id": "cd7181c5-0ee1-49d7-812d-a787aaabbc92",
    "notify_hook": "",
    "action": "LYRICS-V2",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1763140449,
    "start_time": 1763140449,
    "finish_time": 1763140466,
    "progress": "100%",
    "search_item": "bec05f47-cb1c-47d7-b29b-3c325140eee0,aaa1ba24-c018-44c2-9625-59d30896bd51",
    "data": [
      {
        "clip_id": "bec05f47-cb1c-47d7-b29b-3c325140eee0",
        "error_message": "",
        "id": "bec05f47-cb1c-47d7-b29b-3c325140eee0",
        "status": "complete",
        "tags": ["relaxed", "atmospheric", "hip hop"],
        "text": "[Verse]\n有一天我若輕聲和你說再見\n只因我又聽到海浪聲\n那些貪婪的人不願相信\n唯有海洋才會包容\n那個無所不知的古老生物\n終有一天也會長眠\n\n[Pre-Chorus]\n而我親愛的\n我在你的懷中\n卻感覺像是\n[Chorus]\n啊 大海\n啊 大海",
        "title": "大海"
      },
      {
        "clip_id": "aaa1ba24-c018-44c2-9625-59d30896bd51",
        "error_message": "",
        "id": "aaa1ba24-c018-44c2-9625-59d30896bd51",
        "status": "complete",
        "tags": ["piano ballad", "slow", "heartfelt", "acoustic"],
        "text": "[Verse]\n從前的我沒學會眼淚\n還是個孩子\n也不曾疲倦\n在夢裡\n說要去遠方流浪\n直到夜裡\n靈魂還在遊蕩\n\n[Pre-Chorus]\n終於有一天\n\n[Chorus]\n我望著大海\n一片蔚藍\n讓靈魂從容地活\n平靜地死去\n天真與青春\n大海會接納我們",
        "title": "大海"
      }
    ]
  },
  "message": ""
}