Suno API: Extend Music

Suno music extension

curl --request POST \
  --url https://api.crun.ai/api/v1/client/job/CreateTask \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "suno/music-extend",
  "callback_url": "https://your-domain.com/api/callback",
  "input": {
    "suno_id": "suno_abc123",
    "mode": "custom",
    "model": "v5",
    "continue_at": 30,
    "title": "Midnight Addiction (Extended)",
    "tags": "Western R&B, female vocal, dark, sensual",
    "prompt": "Keep the same dark R&B mood and extend with a new bridge and outro.",
    "vocal_gender": "f",
    "style_weight": 0.85,
    "audio_weight": 0.6,
    "weirdness_constraint": 0.2,
    "negative_tags": "metal, aggressive"
  }
}
'

import requests

url = "https://api.crun.ai/api/v1/client/job/CreateTask"

payload = {
    "model": "suno/music-extend",
    "callback_url": "https://your-domain.com/api/callback",
    "input": {
        "suno_id": "suno_abc123",
        "mode": "custom",
        "model": "v5",
        "continue_at": 30,
        "title": "Midnight Addiction (Extended)",
        "tags": "Western R&B, female vocal, dark, sensual",
        "prompt": "Keep the same dark R&B mood and extend with a new bridge and outro.",
        "vocal_gender": "f",
        "style_weight": 0.85,
        "audio_weight": 0.6,
        "weirdness_constraint": 0.2,
        "negative_tags": "metal, aggressive"
    }
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'suno/music-extend',
    callback_url: 'https://your-domain.com/api/callback',
    input: {
      suno_id: 'suno_abc123',
      mode: 'custom',
      model: 'v5',
      continue_at: 30,
      title: 'Midnight Addiction (Extended)',
      tags: 'Western R&B, female vocal, dark, sensual',
      prompt: 'Keep the same dark R&B mood and extend with a new bridge and outro.',
      vocal_gender: 'f',
      style_weight: 0.85,
      audio_weight: 0.6,
      weirdness_constraint: 0.2,
      negative_tags: 'metal, aggressive'
    }
  })
};

fetch('https://api.crun.ai/api/v1/client/job/CreateTask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.crun.ai/api/v1/client/job/CreateTask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'suno/music-extend',
    'callback_url' => 'https://your-domain.com/api/callback',
    'input' => [
        'suno_id' => 'suno_abc123',
        'mode' => 'custom',
        'model' => 'v5',
        'continue_at' => 30,
        'title' => 'Midnight Addiction (Extended)',
        'tags' => 'Western R&B, female vocal, dark, sensual',
        'prompt' => 'Keep the same dark R&B mood and extend with a new bridge and outro.',
        'vocal_gender' => 'f',
        'style_weight' => 0.85,
        'audio_weight' => 0.6,
        'weirdness_constraint' => 0.2,
        'negative_tags' => 'metal, aggressive'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.crun.ai/api/v1/client/job/CreateTask"

	payload := strings.NewReader("{\n  \"model\": \"suno/music-extend\",\n  \"callback_url\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"suno_id\": \"suno_abc123\",\n    \"mode\": \"custom\",\n    \"model\": \"v5\",\n    \"continue_at\": 30,\n    \"title\": \"Midnight Addiction (Extended)\",\n    \"tags\": \"Western R&B, female vocal, dark, sensual\",\n    \"prompt\": \"Keep the same dark R&B mood and extend with a new bridge and outro.\",\n    \"vocal_gender\": \"f\",\n    \"style_weight\": 0.85,\n    \"audio_weight\": 0.6,\n    \"weirdness_constraint\": 0.2,\n    \"negative_tags\": \"metal, aggressive\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.crun.ai/api/v1/client/job/CreateTask")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"suno/music-extend\",\n  \"callback_url\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"suno_id\": \"suno_abc123\",\n    \"mode\": \"custom\",\n    \"model\": \"v5\",\n    \"continue_at\": 30,\n    \"title\": \"Midnight Addiction (Extended)\",\n    \"tags\": \"Western R&B, female vocal, dark, sensual\",\n    \"prompt\": \"Keep the same dark R&B mood and extend with a new bridge and outro.\",\n    \"vocal_gender\": \"f\",\n    \"style_weight\": 0.85,\n    \"audio_weight\": 0.6,\n    \"weirdness_constraint\": 0.2,\n    \"negative_tags\": \"metal, aggressive\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.crun.ai/api/v1/client/job/CreateTask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"suno/music-extend\",\n  \"callback_url\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"suno_id\": \"suno_abc123\",\n    \"mode\": \"custom\",\n    \"model\": \"v5\",\n    \"continue_at\": 30,\n    \"title\": \"Midnight Addiction (Extended)\",\n    \"tags\": \"Western R&B, female vocal, dark, sensual\",\n    \"prompt\": \"Keep the same dark R&B mood and extend with a new bridge and outro.\",\n    \"vocal_gender\": \"f\",\n    \"style_weight\": 0.85,\n    \"audio_weight\": 0.6,\n    \"weirdness_constraint\": 0.2,\n    \"negative_tags\": \"metal, aggressive\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_12345678"
  }
}

{
  "code": 422,
  "message": "Missing Params or Type Error",
  "errors": [
    "specific error field message"
  ]
}

POST

api

client

job

CreateTask

Suno music extension

curl --request POST \
  --url https://api.crun.ai/api/v1/client/job/CreateTask \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "suno/music-extend",
  "callback_url": "https://your-domain.com/api/callback",
  "input": {
    "suno_id": "suno_abc123",
    "mode": "custom",
    "model": "v5",
    "continue_at": 30,
    "title": "Midnight Addiction (Extended)",
    "tags": "Western R&B, female vocal, dark, sensual",
    "prompt": "Keep the same dark R&B mood and extend with a new bridge and outro.",
    "vocal_gender": "f",
    "style_weight": 0.85,
    "audio_weight": 0.6,
    "weirdness_constraint": 0.2,
    "negative_tags": "metal, aggressive"
  }
}
'

import requests

url = "https://api.crun.ai/api/v1/client/job/CreateTask"

payload = {
    "model": "suno/music-extend",
    "callback_url": "https://your-domain.com/api/callback",
    "input": {
        "suno_id": "suno_abc123",
        "mode": "custom",
        "model": "v5",
        "continue_at": 30,
        "title": "Midnight Addiction (Extended)",
        "tags": "Western R&B, female vocal, dark, sensual",
        "prompt": "Keep the same dark R&B mood and extend with a new bridge and outro.",
        "vocal_gender": "f",
        "style_weight": 0.85,
        "audio_weight": 0.6,
        "weirdness_constraint": 0.2,
        "negative_tags": "metal, aggressive"
    }
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'suno/music-extend',
    callback_url: 'https://your-domain.com/api/callback',
    input: {
      suno_id: 'suno_abc123',
      mode: 'custom',
      model: 'v5',
      continue_at: 30,
      title: 'Midnight Addiction (Extended)',
      tags: 'Western R&B, female vocal, dark, sensual',
      prompt: 'Keep the same dark R&B mood and extend with a new bridge and outro.',
      vocal_gender: 'f',
      style_weight: 0.85,
      audio_weight: 0.6,
      weirdness_constraint: 0.2,
      negative_tags: 'metal, aggressive'
    }
  })
};

fetch('https://api.crun.ai/api/v1/client/job/CreateTask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.crun.ai/api/v1/client/job/CreateTask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'suno/music-extend',
    'callback_url' => 'https://your-domain.com/api/callback',
    'input' => [
        'suno_id' => 'suno_abc123',
        'mode' => 'custom',
        'model' => 'v5',
        'continue_at' => 30,
        'title' => 'Midnight Addiction (Extended)',
        'tags' => 'Western R&B, female vocal, dark, sensual',
        'prompt' => 'Keep the same dark R&B mood and extend with a new bridge and outro.',
        'vocal_gender' => 'f',
        'style_weight' => 0.85,
        'audio_weight' => 0.6,
        'weirdness_constraint' => 0.2,
        'negative_tags' => 'metal, aggressive'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.crun.ai/api/v1/client/job/CreateTask"

	payload := strings.NewReader("{\n  \"model\": \"suno/music-extend\",\n  \"callback_url\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"suno_id\": \"suno_abc123\",\n    \"mode\": \"custom\",\n    \"model\": \"v5\",\n    \"continue_at\": 30,\n    \"title\": \"Midnight Addiction (Extended)\",\n    \"tags\": \"Western R&B, female vocal, dark, sensual\",\n    \"prompt\": \"Keep the same dark R&B mood and extend with a new bridge and outro.\",\n    \"vocal_gender\": \"f\",\n    \"style_weight\": 0.85,\n    \"audio_weight\": 0.6,\n    \"weirdness_constraint\": 0.2,\n    \"negative_tags\": \"metal, aggressive\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.crun.ai/api/v1/client/job/CreateTask")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"suno/music-extend\",\n  \"callback_url\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"suno_id\": \"suno_abc123\",\n    \"mode\": \"custom\",\n    \"model\": \"v5\",\n    \"continue_at\": 30,\n    \"title\": \"Midnight Addiction (Extended)\",\n    \"tags\": \"Western R&B, female vocal, dark, sensual\",\n    \"prompt\": \"Keep the same dark R&B mood and extend with a new bridge and outro.\",\n    \"vocal_gender\": \"f\",\n    \"style_weight\": 0.85,\n    \"audio_weight\": 0.6,\n    \"weirdness_constraint\": 0.2,\n    \"negative_tags\": \"metal, aggressive\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.crun.ai/api/v1/client/job/CreateTask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"suno/music-extend\",\n  \"callback_url\": \"https://your-domain.com/api/callback\",\n  \"input\": {\n    \"suno_id\": \"suno_abc123\",\n    \"mode\": \"custom\",\n    \"model\": \"v5\",\n    \"continue_at\": 30,\n    \"title\": \"Midnight Addiction (Extended)\",\n    \"tags\": \"Western R&B, female vocal, dark, sensual\",\n    \"prompt\": \"Keep the same dark R&B mood and extend with a new bridge and outro.\",\n    \"vocal_gender\": \"f\",\n    \"style_weight\": 0.85,\n    \"audio_weight\": 0.6,\n    \"weirdness_constraint\": 0.2,\n    \"negative_tags\": \"metal, aggressive\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_12345678"
  }
}

{
  "code": 422,
  "message": "Missing Params or Type Error",
  "errors": [
    "specific error field message"
  ]
}

Important Notes

This endpoint requires a valid suno_id that references an existing Suno music. If you need to upload an audio extension, please refer to: upload audio extend.
Supports two extension modes: simple and custom
In simple mode, other optional parameters inherit from the original suno_id
In custom mode, continue_at, title, tags, and prompt are required

If you are extending an existing track with minimal changes, recommend start with mode=simple.

Extend Music (Simple Mode)

Extend an existing Suno song using its suno_id. Optional parameters are inherited from the original song.

{
    "model": "suno/music-extend",
    "callback_url": "",
    "input": {
        "suno_id": "suno_abc123",
        "mode": "simple",
        "model": "v5"
    }
}

{
    "model": "suno/music-extend",
    "callback_url": "",
    "input": {
        "suno_id": "suno_abc123",
        "mode": "simple",
        "model": "v5",
        "continue_at": 30
    }
}

Extend Music (Custom Mode)

Custom extension lets you control the continuation point and content. You must specify continue_at, title, tags, and prompt.

{
    "model": "suno/music-extend",
    "callback_url": "",
    "input": {
        "suno_id": "suno_abc123",
        "mode": "custom",
        "model": "v5",
        "continue_at": 30,
        "title": "Midnight Addiction (Extended)",
        "tags": "Western R&B, female vocal, dark, sensual",
        "prompt": "Keep the same dark R&B mood and extend with a new bridge and outro.",
        "vocal_gender": "f",
        "style_weight": 0.85,
        "audio_weight": 0.6,
        "weirdness_constraint": 0.2,
        "negative_tags": "metal, aggressive"
    }
}

Get Task Result

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Suno Task Info

Learn how to query suno task status and retrieve generation results

Authorizations

x-api-key

string

header

required

All APIs require authentication via API Key.

Get API Key:

Visit API Key Management Page to get your API Key

Usage: Add to request header:

x-api-key: YOUR_API_KEY

Note:

Keep your API Key secure and do not share it with others
If you suspect your API Key has been compromised, reset it immediately in the management page

Body

application/json

model

enum<string>

required

The model name to use for generation. Required field.

Must be suno/music-extend for this endpoint

Available options:

suno/music-extend

input

object

required

Input parameters for Suno music extension.

Rules:

suno_id is required and must reference an existing Suno song.
mode=simple: other optional fields inherit from the original suno_id.
mode=custom: continue_at, title, tags, and prompt are required.
model=v4: tags max length is 200 and prompt max length is 3000; other models: tags max length 1000 and prompt max length 5000.

Show child attributes

callback_url

string<uri>

Optional. Callback URL for receiving task completion notifications.

System will POST task status and results to this URL when generation completes
Callback payloads structure is consistent with the data object returned by the task status query
Your callback endpoint should accept POST requests with JSON payload containing results
It returns an HTTP 200 status code upon successful receipt

Example:

"https://your-domain.com/api/callback"

Response

Request successful

code

enum<integer>

Response status code

200: Success - Request has been processed successfully
401: Unauthorized - Authentication credentials are missing or invalid
402: Insufficient Credits - Account does not have enough credits to perform the operation
404: Not Found - The requested resource or endpoint does not exist
422: Validation Error - The request parameters failed validation checks
429: Rate Limited - Request limit has been exceeded for this resource
455: Service Unavailable - System is currently undergoing maintenance
500: Server Error - An unexpected error occurred while processing the request
501: Generation Failed - Content generation task failed
505: Feature Disabled - The requested feature is currently disabled

Available options:

200,

401,

402,

404,

422,

429,

455,

500,

501,

505

message

string

Response message, error description when failed

Example:

"success"

data

object

Show child attributes

Cover Music Upload Audio Extend

Introduction

API Reference

Suno Task

Suno API: Extend Music

Important Notes

Extend Music (Simple Mode)

Extend Music (Custom Mode)

Get Task Result

Get Suno Task Info

Authorizations

Body

Response

​Important Notes

​Extend Music (Simple Mode)

​Extend Music (Custom Mode)

​Get Task Result

Get Suno Task Info

Authorizations

Body

Response

Important Notes

Extend Music (Simple Mode)

Extend Music (Custom Mode)

Get Task Result