curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "extend-music",
"callback_url": "https://your-domain.com/callback",
"input": {
"default_param_flag": true,
"audio_id": "audio_abc123",
"instrumental": false,
"prompt": "Continue with an energetic chorus section",
"style": "Pop, Upbeat",
"title": "Summer Vibes Extended",
"continue_at": 120,
"mv": "V5_5",
"negative_tags": "Heavy Metal, Sad",
"style_weight": 0.7
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}Suno AI
Extend Music
Extend or modify existing music by creating a continuation based on a source audio track
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "extend-music",
"callback_url": "https://your-domain.com/callback",
"input": {
"default_param_flag": true,
"audio_id": "audio_abc123",
"instrumental": false,
"prompt": "Continue with an energetic chorus section",
"style": "Pop, Upbeat",
"title": "Summer Vibes Extended",
"continue_at": 120,
"mv": "V5_5",
"negative_tags": "Heavy Metal, Sad",
"style_weight": 0.7
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the response result through the unified Query Music Detail endpoint.
instrumental explicitly controls vocal output. persona_model accepts style_persona or voice_persona with persona_id only when default_param_flag: true on V5/V5_5.
Usage Guide
- This endpoint extends an existing audio track from a specified point
- You can customize the extension with new style, prompt, and title, or inherit from the original track
- Use
default_param_flagto control whether to use custom parameters or original track settings
Parameter Details
-
In Custom Mode (
default_param_flag: true):-
style,title, andcontinue_atare required -
promptis required for vocal extensions. Wheninstrumental: true,promptis not sent. -
continue_atspecifies the timestamp (in seconds) where extension begins -
Character limits vary by model:
- V4:
prompt3000 characters,style200 characters,title80 characters - V4_5 & V4_5PLUS:
prompt5000 characters,style1000 characters,title100 characters - V4_5ALL:
prompt5000 characters,style1000 characters,title80 characters - V5:
prompt5000 characters,style1000 characters,title100 characters - V5_5:
prompt5000 characters,style1000 characters,title100 characters
- V4:
-
-
In Simple Mode (
default_param_flag: false):- Only
audio_idis required; the source track settings are inherited
- Only
Developer Notes
-
Ensure you have a valid
audio_idfrom a previously generated track before using this endpoint -
The extension will seamlessly continue from the specified
continue_attimestamp
Optional parameters
-
negative_tags(string): Music styles or characteristics to exclude from the extension. -
vocal_gender(string): Vocal gender preference. Usemfor male,ffor female. Note: This parameter increases the probability but cannot guarantee adherence. -
style_weight(number): Strength of adherence to style. Range 0-1, up to 2 decimals. -
weirdness_constraint(number): Controls creative deviation. Range 0-1, up to 2 decimals. -
audio_weight(number): Balance weight for audio features. Range 0-1, up to 2 decimals. -
persona_id(string): Persona ID to apply to the extended music. Only available whendefault_param_flag: truewith V5/V5_5. How to generate persona_id, visit generate-persona. -
persona_model(string):style_personaorvoice_persona. Requirespersona_id,default_param_flag: true, and V5/V5_5.
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer PoYo_API_KEY
Body
application/json
API model identifier.
Must be extend-music for this endpoint.
Available options:
extend-music Example:
"extend-music"
Input parameters for music extension
Show child attributes
Show child attributes
Webhook callback URL for result notifications.
Endpoint that receives task completion updates.
Example:
"https://your-domain.com/callback"