v1

latestOpenAPI 3.0.02026-07-26355125.0 KB

Extend Music

post/api/v1/generate/extend

Request body

defaultParamFlagboolean required

Controls parameter usage mode.

true: Use custom parameters (requires continueAt, prompt, style, and title).
false: Use original audio parameters (only audioId is required).

audioIdstring required

Audio ID of the track to extend. This is the source track that will be continued.

promptstring

Description of how the music should be extended. Required when defaultParamFlag is true.

stylestring

Music style, e.g., Jazz, Classical, Electronic

titlestring

Music title

continueAtnumber

The time point (in seconds) from which to start extending the music.

Required when defaultParamFlag is true.
Value range: greater than 0 and less than the total duration of the generated audio.
Specifies the position in the original track where the extension should begin.

personaIdstring

Only available when custom parameters are enabled. Persona ID to apply to the generated music. Optional. You can use either:

A Persona ID generated by the Generate Persona endpoint. Use personaModel: style_persona or omit personaModel to use the default.
A voiceId generated by the Suno Voice workflow. When using a voice-generated ID, you must set personaModel: voice_persona.

personaModel'style_persona' | 'voice_persona'

Persona model type to apply when using personaId. Optional.

style_persona (default): Use this for Persona IDs generated by the Generate Persona endpoint.
voice_persona: Use this when personaId is a voiceId generated by Suno Voice. This option is only available with V5 and V5_5 models.

Model version to use, must be consistent with the source audio.

Available options:
- V5_5: Unleash Your Voice: Custom Models Tailored to Your Unique Taste.
- V5: Superior musical expression, faster generation.
- V4_5PLUS: V4.5+ is richer sound, new waysto create, max 8 min.
- V4_5ALL: V4.5-all is better song structure, max 8 min.
- V4_5: V4.5 is smarter prompts, fastergenerations, max 8 min.
- V4: V4 is improved vocal quality,max 4 min.

negativeTagsstring

Music styles to exclude from generation

vocalGender'm' | 'f'

Preferred vocal gender for generated vocals. Optional.

styleWeightnumber

Weight of the provided style guidance. Range 0.00–1.00.

weirdnessConstraintnumber

Constraint on creative deviation/novelty. Range 0.00–1.00.

audioWeightnumber

Weight of the input audio influence (where applicable). Range 0.00–1.00.

callBackUrlstring uri required

The URL to receive task completion notifications when music extension is complete.

For detailed callback format and implementation guide, see Music Extension Callbacks
Alternatively, you can use the get music generation details endpoint to poll task status

Example request

{
  "defaultParamFlag": true,
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "prompt": "Extend the music with more relaxing notes",
  "style": "Classical",
  "title": "Peaceful Piano Extended",
  "continueAt": 60,
  "personaId": "persona_123",
  "personaModel": "style_persona",
  "model": "V4_5ALL",
  "negativeTags": "Relaxing Piano",
  "vocalGender": "m",
  "styleWeight": 0.65,
  "weirdnessConstraint": 0.65,
  "audioWeight": 0.65,
  "callBackUrl": "https://api.example.com/callback"
}

Response

Request successful

code200 | 400 | 401 | 404 | 405 | 413 | 429 | 430 | 455 | 500

Status Codes

✅ 200 - Request successful
⚠️ 400 - Invalid parameters
⚠️ 401 - Unauthorized access
⚠️ 404 - Invalid request method or path
⚠️ 405 - Rate limit exceeded
⚠️ 413 - Theme or prompt too long
⚠️ 429 - Insufficient credits
⚠️ 430 - Your call frequency is too high. Please try again later.
⚠️ 455 - System maintenance
❌ 500 - Server error

msgstring

Error message when code != 200

Example response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}