Skip to Content
DocumentationModelsMusicSunomusic-video

Suno: music-video

Create a visualized MP4 from a prior track.

Action facts

PropertyValue
Modelsuno
Actionmusic-video
EndpointPOST /api/v1/generation/create
ResultMP4 in files
PricingView current pricing 

Minimal request

curl -X POST https://api.api-stock.com/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno",
  "input": {
    "action": "music-video",
    "sourceTaskId": "019ca881-9503-7270-a560-f00fc2b15785"
  }
}'
{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Parameters

ParameterTypeRequiredDefaultDescription
action“music” | “extend” | “cover” | “add-instrumental” | “add-vocals” | “sound” | “stems” | “stems-all” | “wav” | “lyrics” | “voice” | “timestamped-lyrics” | “boost-style” | “music-cover” | “replace-section” | “music-video” | “inspo” | “upload” | “remaster” | “add-stem” | “vox” | “remove-section” | “crop” | “fade-in” | “fade-out” | “adjust-speed” | “concat” | “mashup” | “sample” | “midi” | “bpm”Yes"music"Suno operation
sourceTaskIdstringYes—Reference to one of your prior Suno generations (its taskId), used by stateful actions such as extend, music-cover, replace-section, timestamped-lyrics, music-video, voice and wav.
authorstringNo—music-video: artist / creator name on the cover (max 50)
domainNamestringNo—music-video: brand / site watermark at the bottom (max 50)
aspectRatio“9:16” | “16:9” | “1:1” | “3:4” | “4:3”No"9:16"music-video: output aspect ratio
backgroundColorsstring[]No—music-video: 1–4 hex colors for the blurred gradient backdrop (e.g. [“#1B2635”, “#8A6A4F”])
imageUrlstringNo—music-video: cover image URL to show inside the ring (default: the source track’s cover art when available)
quality“compact” | “high” | “max”No"compact"music-video: output quality. compact — small share-friendly file (~5MB / 3 min); high — sharper 720p-class output at roughly double the size; max — 1080p-class, ~4× compact

Conditional rules: Requires sourceTaskId.

Only send fields relevant to this action. When a request references sourceTaskId, the source must be a successful Suno task owned by the same account.

Result

curl https://api.api-stock.com/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

You can instead provide a top-level webhook. The task reaches finished, failed or expired; failed generations are refunded automatically. Data actions return output, while media actions return files.

{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "files": [
      {
        "fileUrl": "https://storage.api-stock.com/result.mp4",
        "fileType": "video"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

Back to all Suno actions

replace-sectioninspo