Documentation
v2
SunoV3.5
Get Generated Or Extend Music

Get Generated Music

GET
https://api.sunoapi.com/api/v2/suno/v3.5/clips

Retrieve progress and response from a task you've sent in a previous create request.

Each create action will result in 2 clips, each with a unique clip ID, mp4 URL, cover image, audio URL and more.

GET /api/v2/suno/v3.5/clips

Query Param

NameLocationTypeRequiredDescription
idsquerystringtruethe clip id from the create request, If you want to query two ids at the same time, separate 2 IDs with commas,like '00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90,7070ec00-462e-42ac-9b9f-1074977f473f'

Sample Response

{
  "clips": [
    {
      "id": "00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90",
      "video_url": "https://cdn1.suno.ai/00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90.mp4",
      "audio_url": "https://cdn1.suno.ai/00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90.mp3",
      "image_url": "https://cdn2.suno.ai/image_00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90.jpeg",
      "image_large_url": "https://cdn2.suno.ai/image_large_00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90.jpeg",
      "is_video_pending": false,
      "major_model_version": "v3.5",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "heavy metal",
        "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
        "gpt_description_prompt": null,
        "audio_prompt_id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
        "history": [
          {
            "id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
            "type": "upload",
            "infill": false,
            "source": "web",
            "continue_at": 48.762
          }
        ],
        "concat_history": null,
        "type": "gen",
        "duration": 191,
        "refund_credits": false,
        "stream": true,
        "infill": false,
        "has_vocal": true,
        "is_audio_upload_tos_accepted": true,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "4ed4f182-0b5a-4cde-bffe-44fb5237a3aa",
      "display_name": "AmbientLens971",
      "handle": "ambientlens971",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.jpg",
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-07-22T07:56:36.711Z",
      "status": "complete",
      "title": "Starry ",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "7070ec00-462e-42ac-9b9f-1074977f473f",
      "video_url": "https://cdn1.suno.ai/7070ec00-462e-42ac-9b9f-1074977f473f.mp4",
      "audio_url": "https://cdn1.suno.ai/7070ec00-462e-42ac-9b9f-1074977f473f.mp3",
      "image_url": "https://cdn2.suno.ai/image_7070ec00-462e-42ac-9b9f-1074977f473f.jpeg",
      "image_large_url": "https://cdn2.suno.ai/image_large_7070ec00-462e-42ac-9b9f-1074977f473f.jpeg",
      "is_video_pending": false,
      "major_model_version": "v3.5",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "heavy metal",
        "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
        "gpt_description_prompt": null,
        "audio_prompt_id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
        "history": [
          {
            "id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
            "type": "upload",
            "infill": false,
            "source": "web",
            "continue_at": 48.762
          }
        ],
        "concat_history": null,
        "type": "gen",
        "duration": 150.56,
        "refund_credits": false,
        "stream": true,
        "infill": false,
        "has_vocal": true,
        "is_audio_upload_tos_accepted": true,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "4ed4f182-0b5a-4cde-bffe-44fb5237a3aa",
      "display_name": "AmbientLens971",
      "handle": "ambientlens971",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.jpg",
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-07-22T07:56:36.710Z",
      "status": "complete",
      "title": "Starry ",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "num_total_results": 2,
  "current_page": 0
}

Response Body

NameTypeDescription
clipsarraythe two generated music data
num_total_resultsnumberthe num of the musics
current_pagestring——

clips

NameTypeDescription
clips.idstringthe clip_id or continue_clip_id uesd for get generated music or expand music.
clips.video_urlstringthe video URL of the clip
clips.audio_urlstringthe audio URL of the clip
clips.image_urlstringthe image URL of the clip
clips.image_large_urlstringthe large image URL of the clip
clips.is_video_pendingbooleanwhether the video is pending to be generated
clips.major_model_versionstringthe major model version used to generate the clips
clips.model_namestringthe model name used to generate the clips
clips.metadataobjectthe metadata of the clips, including tags, prompt, audio prompt ID, history, concat history, type, duration, refund credits, stream, error type, error message, etc.
clips.is_likedbooleanwhether the clip is liked
clips.user_idstringthe user ID of the clip
clips.display_namestringthe display name of the clip
clips.handlestringthe handle of the clip
clips.is_handle_updatedbooleanwhether the handle is updated
clips.is_trashedbooleanwhether the clip is trashed
clips.reactionobjectthe reaction of the clip, including upvote count, like count, and dislike count
clips.created_atstringthe created at of the clip
clips.statusstringthe status of the clip
clips.titlestringthe title of the clip
clips.play_countnumberthe play count of the clip
clips.upvote_countnumberthe upvote count of the clip
clips.is_publicbooleanwhether the clip is public

Examples

const axios = require("axios")
 
const config = {
  method: "get",
  url: "https://api.sunoapi.com/api/v2/suno/v3.5/clips",
  params: {
    ids: "00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90,7070ec00-462e-42ac-9b9f-1074977f473f",
  },
  headers: {
    Authorization: "Bearer <your-token>",
  },
}
 
axios(config)
  .then(function (response) {
    console.log(JSON.stringify(response.data))
  })
  .catch(function (error) {
    console.log(error)
  })
Extend MusicPrivacy Policy