Suno Newapi フォーマット

2024.10.29 Newapiフォーマットに対応しました

チャンネル -> チャンネル追加に移動し、以下のように設定します

newapi

1. 歌詞生成

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": "乡愁"
}'

レスポンスのdataフィールドがタスクtask_idです

json

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

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

2. 音楽生成

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. インスピレーションモード

リクエストボディ

json

{
  "gpt_description_prompt": "乡愁"
}

{
  "gpt_description_prompt": "乡愁"
}

b. カスタムモード

リクエストボディ

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. 続き

リクエストボディ

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. その他のモード

その他のモードシナリオについては、Sunoシーンアプリケーションを参照してください

リクエストボディパラメータ説明

パラメータ	説明	型	デフォルト
gpt_description_prompt	インスピレーションプロンプト	string
mv	モデル、有効な値：`chirp-v3-0` `chirp-v3-5`	string	chirp-v3-0
title	タイトル	string
prompt	歌詞	string
tags	曲のスタイル、複数のスタイルはスペースで区切る	string
continue_at	開始時間	integer(int64)
continue_clip_id	前の曲のID	string

音楽レスポンスボディ

上記3つのモードすべての最終レスポンスのdataフィールドがタスクtask_idです

json

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

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

3. 単一タスク取得

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

レスポンスボディ - 歌詞

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": ""
}

レスポンスボディ - 音楽

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. バッチタスク取得

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"
  ]
}'

リクエストボディ

json

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

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

レスポンスボディ

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. 曲の結合

mp3のみサポート
リソース集約的なため、200クレジットが差し引かれます
post https://api.openai-hk.com/suno/submit/concat

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
}'

リクエストボディ

json

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

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

レスポンスのdataフィールドがtask_idです

json

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

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

6. オーディオアップロード

mp3のみサポート
リソース集約的なため、200クレジットが差し引かれます

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

リクエストボディ

json

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

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

レスポンスボディ

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": ""
}

取得したclip_idを二次創作に使用します。6 取得して二次創作を実行を参照してください
Newapiフォーマットに対応、dataがclip_idです
curlデモ

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. 歌詞生成 V2

7.1 歌詞生成タスク

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

lyrics_modelはremi-v1と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"
}'

レスポンスのdataフィールドがタスク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 https://api.openai-hk.com/suno/fetch/cd7181c5-0ee1-49d7-812d-a787aaabbc92

返却結果

data.actionはタスクLYRICS-V2です
data.data[0].idはタスクlyrics_a_idまたは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": ""
}

Suno Newapi フォーマット ​

1. 歌詞生成 ​

2. 音楽生成 ​

a. インスピレーションモード ​

b. カスタムモード ​

c. 続き ​

D. その他のモード ​

リクエストボディパラメータ説明 ​

音楽レスポンスボディ ​

3. 単一タスク取得 ​

4. バッチタスク取得 ​

5. 曲の結合 ​

6. オーディオアップロード ​

7. 歌詞生成 V2 ​

7.1 歌詞生成タスク ​

7.2 歌詞取得 ​

Suno Newapi フォーマット

1. 歌詞生成

2. 音楽生成

a. インスピレーションモード

b. カスタムモード

c. 続き

D. その他のモード

リクエストボディパラメータ説明

音楽レスポンスボディ

3. 単一タスク取得

4. バッチタスク取得

5. 曲の結合

6. オーディオアップロード

7. 歌詞生成 V2

7.1 歌詞生成タスク

7.2 歌詞取得