Extend music

curl --request POST \
  --url https://apistable.com/api/v1/tasks/create_task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno_extend",
  "input": {
    "model": "V6",
    "audio_id": "YOUR_AUDIO_ID",
    "continue_at": 60,
    "style": "Synth pop"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'suno_extend',
    input: {model: 'V6', audio_id: 'YOUR_AUDIO_ID', continue_at: 60, style: 'Synth pop'}
  })
};

fetch('https://apistable.com/api/v1/tasks/create_task', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apistable.com/api/v1/tasks/create_task"

payload = {
    "model": "suno_extend",
    "input": {
        "model": "V6",
        "audio_id": "YOUR_AUDIO_ID",
        "continue_at": 60,
        "style": "Synth pop"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "<string>"
  }
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

POST

api

tasks

create_task

Extend music

curl --request POST \
  --url https://apistable.com/api/v1/tasks/create_task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno_extend",
  "input": {
    "model": "V6",
    "audio_id": "YOUR_AUDIO_ID",
    "continue_at": 60,
    "style": "Synth pop"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'suno_extend',
    input: {model: 'V6', audio_id: 'YOUR_AUDIO_ID', continue_at: 60, style: 'Synth pop'}
  })
};

fetch('https://apistable.com/api/v1/tasks/create_task', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apistable.com/api/v1/tasks/create_task"

payload = {
    "model": "suno_extend",
    "input": {
        "model": "V6",
        "audio_id": "YOUR_AUDIO_ID",
        "continue_at": 60,
        "style": "Synth pop"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "<string>"
  }
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

Operations are enabled individually by server configuration. Disabled operations return 503 without a task. Music credit deduction is currently disabled.

Using this operation

Provide an audio ID and the point to continue from. For generated songs, select the source song’s model version.

1. Prepare the fields shown in the example below. Replace sample URLs and IDs with resources you can access.
1. Set model to suno_extend and place the parameters inside input. Submit once and save the returned task_id.
1. Query the saved task or receive its callback. A processing result is not a reason to submit the operation again.
Read songs from result.data.data. Each song has its own APIstable id, which can be used as audio_id in a later task.

Create task

One operation, one execution item. The server records the provider, account, every upstream stage and output mapping. All IDs in the public API are APIstable IDs. Music credit deduction is not enabled.

{
  "model": "suno_extend",
  "input": {
    "model": "V6",
    "audio_id": "YOUR_AUDIO_ID",
    "continue_at": 60,
    "style": "Synth pop"
  }
}

Parameter reference

Field	Type	Required	Description and limits
lyrics	string	No / conditional	Lyrics, up to 5000 characters; takes precedence over prompt where both are accepted. maxLength: 5000
prompt	string	No / conditional	Simple description: up to 3000 characters. In custom mode, lyrics takes precedence over prompt (up to 5000). maxLength: 5000
style	string	No / conditional	Musical style, up to 1000 characters. Counts as one attachment in simple generation. maxLength: 1000
negative_tags	string	No / conditional	Styles to exclude; required for adding instrumental backing or vocals. maxLength: 1000
vocal_gender	string	No / conditional	m or f. A vocal tendency, not a guaranteed voice identity. Custom generation only. values: m, f
style_weight	number	No / conditional	Style influence, 0–1 with at most two decimal places. Custom generation only. min: 0; max: 1
weirdness_constraint	number	No / conditional	Creativity constraint, 0–1 with at most two decimal places. Custom generation only. min: 0; max: 1
audio_weight	number	No / conditional	Audio influence, 0–1 with at most two decimal places. Generation requires custom, non-instrumental mode. min: 0; max: 1
variety	integer	No / conditional	Variety: integer 0–4, default 1 in custom generation. min: 0; max: 4
persona_id	string	No / conditional	APIstable Voice or Persona ID; provider root and artist mapping remain server-side. maxLength: 200
persona_model	string	No / conditional	style_persona or voice_persona; must match the resource’s actual origin. values: style_persona, voice_persona
max_mode	boolean	No / conditional	PayAPI extension. Max mode may increase supplier cost. APIstable credit deduction is currently disabled. default: false
model	string	Yes	Suno version: V6, V6_MINI or V6_WILD. Extension must match the generated source model. values: V6, V6_MINI, V6_WILD
audio_id	string	Yes	APIstable song ID. Server resolves ownership, selected attempt and supplier clip using primary-key joins. No source task_id or external upload_url is accepted for cover/extend. maxLength: 200
instrumental	boolean	No / conditional	Generate instrumental music. Instrumental extensions omit prompt, lyrics and vocal_gender.
title	string	No / conditional	Title. Generate/cover: up to 80 characters; extend and other operations: up to 100. Required for custom generation. maxLength: 100
continue_at	number	No / conditional	Extension start in seconds, greater than zero and less than source duration. min: 0
source_lyrics	string	No / conditional	PayAPI extension: source lyrics for Persona extension, separate from new lyrics. maxLength: 5000
result_mode	string	No / conditional	Extension/replacement: full_song (default) or segment. Added stem: mixed (default) or stem. Full/mixed results wait for assembly. values: full_song, segment; default: full_song

Inputs and limits

Read the input schema below for every supported field, required flag, enum, range and default. Unknown parameters are rejected. URL fields accept public HTTPS URLs, never file objects.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "lyrics": {
      "type": "string",
      "maxLength": 5000,
      "description": "Lyrics, up to 5000 characters; takes precedence over prompt where both are accepted."
    },
    "prompt": {
      "type": "string",
      "maxLength": 5000,
      "description": "Simple description: up to 3000 characters. In custom mode, lyrics takes precedence over prompt (up to 5000)."
    },
    "style": {
      "type": "string",
      "maxLength": 1000,
      "description": "Musical style, up to 1000 characters. Counts as one attachment in simple generation."
    },
    "negative_tags": {
      "type": "string",
      "maxLength": 1000,
      "description": "Styles to exclude; required for adding instrumental backing or vocals."
    },
    "vocal_gender": {
      "type": "string",
      "enum": [
        "m",
        "f"
      ],
      "description": "m or f. A vocal tendency, not a guaranteed voice identity. Custom generation only."
    },
    "style_weight": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Style influence, 0–1 with at most two decimal places. Custom generation only."
    },
    "weirdness_constraint": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Creativity constraint, 0–1 with at most two decimal places. Custom generation only."
    },
    "audio_weight": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Audio influence, 0–1 with at most two decimal places. Generation requires custom, non-instrumental mode."
    },
    "variety": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "description": "Variety: integer 0–4, default 1 in custom generation."
    },
    "persona_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "APIstable Voice or Persona ID; provider root and artist mapping remain server-side."
    },
    "persona_model": {
      "type": "string",
      "enum": [
        "style_persona",
        "voice_persona"
      ],
      "description": "style_persona or voice_persona; must match the resource's actual origin."
    },
    "max_mode": {
      "default": false,
      "type": "boolean",
      "description": "PayAPI extension. Max mode may increase supplier cost. APIstable credit deduction is currently disabled."
    },
    "model": {
      "type": "string",
      "enum": [
        "V6",
        "V6_MINI",
        "V6_WILD"
      ],
      "description": "Suno version: V6, V6_MINI or V6_WILD. Extension must match the generated source model."
    },
    "audio_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "APIstable song ID. Server resolves ownership, selected attempt and supplier clip using primary-key joins. No source task_id or external upload_url is accepted for cover/extend."
    },
    "instrumental": {
      "type": "boolean",
      "description": "Generate instrumental music. Instrumental extensions omit prompt, lyrics and vocal_gender."
    },
    "title": {
      "type": "string",
      "maxLength": 100,
      "description": "Title. Generate/cover: up to 80 characters; extend and other operations: up to 100. Required for custom generation."
    },
    "continue_at": {
      "type": "number",
      "minimum": 0,
      "description": "Extension start in seconds, greater than zero and less than source duration."
    },
    "source_lyrics": {
      "type": "string",
      "maxLength": 5000,
      "description": "PayAPI extension: source lyrics for Persona extension, separate from new lyrics."
    },
    "result_mode": {
      "default": "full_song",
      "type": "string",
      "enum": [
        "full_song",
        "segment"
      ],
      "description": "Extension/replacement: full_song (default) or segment. Added stem: mixed (default) or stem. Full/mixed results wait for assembly."
    }
  },
  "required": [
    "model",
    "audio_id"
  ],
  "additionalProperties": false
}

Important conditions

Song audio may be MP3 or M4A, matching the supplier media. M4A is never relabeled as MP3. Use suno_export_mp3 for an actual MP3. Unavailable optional covers are null; the audio remains usable.
Cover and extend accept only audio_id, without an external URL or source task_id. Extension model must match a generated source song. Expired or foreign-account resources are rejected.
Full-song extension/replacement and mixed added stems wait for assembly. A failed assembly is never delivered as a full song. Partial song success is identified in the result message.
PayAPI restrictions: replacement ranges above 120 seconds, generated Voice Persona cover/extend and Persona replacement remain gated until verified. Native single-stem extraction currently supports the documented Piano value.
Uploads remain available for 24 hours, generated files for 14 days, task details for 30 days. MP3 reuse keeps the source expiry. Valid Voice identity mappings survive task-log cleanup.

Result

The creation response is {code:200,msg:“success”,data:{task_id}}. Poll GET /api/v1/tasks/{task_id}. On success, data.result is an object matching the schema below; it is otherwise null. input remains a JSON string.

{
  "type": "object",
  "required": [
    "code",
    "msg",
    "data"
  ],
  "properties": {
    "code": {
      "const": 200
    },
    "msg": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "required": [
        "callbackType",
        "task_id",
        "data"
      ],
      "properties": {
        "callbackType": {
          "const": "complete"
        },
        "task_id": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "audio_url",
              "stream_audio_url",
              "image_url",
              "prompt",
              "lyrics",
              "model_name",
              "title",
              "createTime",
              "duration",
              "tags",
              "source_audio_url",
              "source_image_url",
              "source_stream_audio_url"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "audio_url": {
                "type": "string"
              },
              "stream_audio_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "image_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "prompt": {
                "type": "string"
              },
              "lyrics": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "model_name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "createTime": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "duration": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "tags": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "source_audio_url": {
                "type": "string"
              },
              "source_image_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "source_stream_audio_url": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      }
    }
  }
}

Voice: all four steps File uploads Callbacks

Authorizations

Authorization

string

header

required

Every valid key can submit and query its own account. Revoked keys are rejected.

Body

application/json

model

enum<string>

required

Available options:

suno_extend

Example:

"suno_extend"

input

object

required

Show child attributes

callback_url

string<uri>

Optional public HTTPS endpoint for signed completion callbacks; no redirects or private IPs.

Response

Accepted task. Poll the common task endpoint or use callback_url.

code

any

required

msg

any

required

data

object

required

Show child attributes

Get started

API reference

Core concepts

Extend music

Using this operation

Create task

Parameter reference

Inputs and limits

Important conditions

Result

Authorizations

Body

Response

​Using this operation

​Create task

​Parameter reference

​Inputs and limits

​Important conditions

​Result

​Related workflows

Authorizations

Body

Response

Using this operation

Create task

Parameter reference

Inputs and limits

Important conditions

Result

Related workflows