Suno Extend-Music
Use the extend music endpoint to create an asynchronous Task.
Overview
Use the extend music endpoint with a supported model. Use the returned Task ID to retrieve its state, or provide callback_url for the deliveries documented below.
Quick start
- Create an API key and set it as RUNAPI_API_KEY.
- Choose a supported model and send a POST request whose body matches that model's schema.
- Store the returned task ID, then poll until a terminal state or handle the callbacks documented below.
Endpoint
- Base URL
https://runapi.ai- API version
v1- Authentication
Authorization: Bearer YOUR_API_TOKEN
Supported models
Open a model page for current pricing, rate limits, and commercial-usage details.
Request schema
Fields and allowed values depend on the selected model. When supplied, callback_url receives the Task deliveries documented below.
suno-v420 fields
audio_idstringSource audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_urlstringSource audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_weightnumberAudio weight (0-1).
callback_urlstringWebhook URL for async notifications.
continue_atnumberSeconds into the source to continue from. Required in custom parameter mode.
instrumentalbooleanWhen true, generate without vocals.
lyricsstringExact lyrics. Only allowed when extending uploaded audio in custom parameter mode.
modelstringModel slug.
negative_tagsstringStyles to avoid.
parameter_modestringInherit the source track's parameters (source) or supply custom ones (custom).
Allowed values:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
Allowed values:style, voice
promptstringExtension brief. Cannot be combined with lyrics.
stylestringStyle preset. Required in custom parameter mode.
style_weightnumberStyle adherence weight (0-1).
task_idstringSource task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
titlestringSong title. Required in custom parameter mode.
upload_urlstringUploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
vocal_genderstringVocal gender.
Allowed values:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v4.520 fields
audio_idstringSource audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_urlstringSource audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_weightnumberAudio weight (0-1).
callback_urlstringWebhook URL for async notifications.
continue_atnumberSeconds into the source to continue from. Required in custom parameter mode.
instrumentalbooleanWhen true, generate without vocals.
lyricsstringExact lyrics. Only allowed when extending uploaded audio in custom parameter mode.
modelstringModel slug.
negative_tagsstringStyles to avoid.
parameter_modestringInherit the source track's parameters (source) or supply custom ones (custom).
Allowed values:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
Allowed values:style, voice
promptstringExtension brief. Cannot be combined with lyrics.
stylestringStyle preset. Required in custom parameter mode.
style_weightnumberStyle adherence weight (0-1).
task_idstringSource task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
titlestringSong title. Required in custom parameter mode.
upload_urlstringUploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
vocal_genderstringVocal gender.
Allowed values:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v4.5-all20 fields
audio_idstringSource audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_urlstringSource audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_weightnumberAudio weight (0-1).
callback_urlstringWebhook URL for async notifications.
continue_atnumberSeconds into the source to continue from. Required in custom parameter mode.
instrumentalbooleanWhen true, generate without vocals.
lyricsstringExact lyrics. Only allowed when extending uploaded audio in custom parameter mode.
modelstringModel slug.
negative_tagsstringStyles to avoid.
parameter_modestringInherit the source track's parameters (source) or supply custom ones (custom).
Allowed values:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
Allowed values:style, voice
promptstringExtension brief. Cannot be combined with lyrics.
stylestringStyle preset. Required in custom parameter mode.
style_weightnumberStyle adherence weight (0-1).
task_idstringSource task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
titlestringSong title. Required in custom parameter mode.
upload_urlstringUploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
vocal_genderstringVocal gender.
Allowed values:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v4.5-plus20 fields
audio_idstringSource audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_urlstringSource audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_weightnumberAudio weight (0-1).
callback_urlstringWebhook URL for async notifications.
continue_atnumberSeconds into the source to continue from. Required in custom parameter mode.
instrumentalbooleanWhen true, generate without vocals.
lyricsstringExact lyrics. Only allowed when extending uploaded audio in custom parameter mode.
modelstringModel slug.
negative_tagsstringStyles to avoid.
parameter_modestringInherit the source track's parameters (source) or supply custom ones (custom).
Allowed values:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
Allowed values:style, voice
promptstringExtension brief. Cannot be combined with lyrics.
stylestringStyle preset. Required in custom parameter mode.
style_weightnumberStyle adherence weight (0-1).
task_idstringSource task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
titlestringSong title. Required in custom parameter mode.
upload_urlstringUploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
vocal_genderstringVocal gender.
Allowed values:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v520 fields
audio_idstringSource audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_urlstringSource audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_weightnumberAudio weight (0-1).
callback_urlstringWebhook URL for async notifications.
continue_atnumberSeconds into the source to continue from. Required in custom parameter mode.
instrumentalbooleanWhen true, generate without vocals.
lyricsstringExact lyrics. Only allowed when extending uploaded audio in custom parameter mode.
modelstringModel slug.
negative_tagsstringStyles to avoid.
parameter_modestringInherit the source track's parameters (source) or supply custom ones (custom).
Allowed values:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
Allowed values:style, voice
promptstringExtension brief. Cannot be combined with lyrics.
stylestringStyle preset. Required in custom parameter mode.
style_weightnumberStyle adherence weight (0-1).
task_idstringSource task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
titlestringSong title. Required in custom parameter mode.
upload_urlstringUploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
vocal_genderstringVocal gender.
Allowed values:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v5.520 fields
audio_idstringSource audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_urlstringSource audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
audio_weightnumberAudio weight (0-1).
callback_urlstringWebhook URL for async notifications.
continue_atnumberSeconds into the source to continue from. Required in custom parameter mode.
instrumentalbooleanWhen true, generate without vocals.
lyricsstringExact lyrics. Only allowed when extending uploaded audio in custom parameter mode.
modelstringModel slug.
negative_tagsstringStyles to avoid.
parameter_modestringInherit the source track's parameters (source) or supply custom ones (custom).
Allowed values:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
Allowed values:style, voice
promptstringExtension brief. Cannot be combined with lyrics.
stylestringStyle preset. Required in custom parameter mode.
style_weightnumberStyle adherence weight (0-1).
task_idstringSource task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
titlestringSong title. Required in custom parameter mode.
upload_urlstringUploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url.
vocal_genderstringVocal gender.
Allowed values:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
Create acceptance
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"id": {
"type": "string"
},
"status": {
"enum": [
"processing"
],
"type": "string"
},
"task_replayed": {
"type": "boolean"
}
},
"required": [
"id",
"status",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}Polling processing
GET /api/v1/suno/extend_music/:id
Response schema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string"
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
},
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"generation_stage": {
"enum": [
"text_generated",
"first_audio_ready"
],
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"processing"
],
"type": "string"
}
},
"required": [
"id",
"status",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}Polling completed
GET /api/v1/suno/extend_music/:id
Response schema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string"
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
},
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"generation_stage": {
"enum": [
"text_generated",
"first_audio_ready",
"all_audios_ready",
"failed"
],
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"audios",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"audios": [
{
"audio_url": "https://file.runapi.ai/reference-audio.mp3",
"id": "audio_reference"
}
],
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "completed"
}Polling failed
GET /api/v1/suno/extend_music/:id
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"failed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"error",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}Customer callback: processing
POST callback_url
Response schema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string"
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
},
"generation_stage": {
"enum": [
"text_generated",
"first_audio_ready"
],
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"processing"
],
"type": "string"
}
},
"required": [
"id",
"status"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}Customer callback: completed
POST callback_url
Response schema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string"
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
},
"generation_stage": {
"enum": [
"text_generated",
"first_audio_ready",
"all_audios_ready",
"failed"
],
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"audios"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"audios": [
{
"audio_url": "https://file.runapi.ai/reference-audio.mp3",
"id": "audio_reference"
}
],
"id": "tsk_reference_demo",
"status": "completed"
}Customer callback: failed
POST callback_url
Response schema
{
"properties": {
"error": {
"oneOf": [
{
"type": "string"
},
{
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"failed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}Errors
POST /api/v1/suno/extend_music
This response has no body.
Errors
GET /api/v1/suno/extend_music/:id
This response has no body.
Errors
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "model_must_be_one_of_suno-v4_suno-v4_5_suno-v4_5-all_suno-v4_5-plus_suno-v5_suno-v5_5",
"message": "model must be one of: suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5"
}
}Errors
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance"
}
}Errors
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "api_token_credit_limit_exceeded",
"message": "API key credit limit exceeded"
}
}Errors
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "request_conflict",
"message": "The request uses features that are not supported for the selected model"
}
}Errors
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "rate_limited",
"message": "Rate limit reached. Please retry later."
}
}Errors
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "service_unavailable",
"message": "Service under maintenance, please try again later"
}
}Errors
POST /api/v1/suno/extend_music
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": {
"code": "timeout_error",
"message": "The request timed out"
}
}Errors
GET /api/v1/suno/extend_music/:id
Response schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Response example
{
"error": {
"code": "not_found",
"message": "Task with id 'tsk_reference_demo' not found"
}
}Generated Code Samples
Use cURL directly, or install an SDK for your language. Each sample submits the validated request shown in this reference.
curl -X POST https://runapi.ai/api/v1/suno/extend_music \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"model":"suno-v5","audio_url":"https://file.runapi.ai/source-audio.mp3","parameter_mode":"source","prompt":"Continue the arrangement with a brighter chorus."}'Install
npm install @runapi.ai/sunoimport { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient({ apiKey: process.env.RUNAPI_API_KEY });
const task = await client.extendMusic.create({
"model": "suno-v5",
"audio_url": "https://file.runapi.ai/source-audio.mp3",
"parameter_mode": "source",
"prompt": "Continue the arrangement with a brighter chorus."
});Install
pip install runapi-sunoimport os
from runapi.suno import SunoClient
client = SunoClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.extend_music.create(
model="suno-v5",
audio_url="https://file.runapi.ai/source-audio.mp3",
parameter_mode="source",
prompt="Continue the arrangement with a brighter chorus."
)Install
go get github.com/runapi-ai/suno-sdk/go@latestpackage main
import (
"context"
"log"
"os"
"github.com/runapi-ai/core-sdk/go/option"
suno "github.com/runapi-ai/suno-sdk/go/suno"
)
func main() {
client, err := suno.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
if err != nil {
log.Fatal(err)
}
task, err := client.ExtendMusic.Create(context.Background(), suno.ExtendMusicParams{
Model: suno.SunoModel("suno-v5"),
AudioURL: "https://file.runapi.ai/source-audio.mp3",
ParameterMode: suno.ParameterMode("source"),
Prompt: "Continue the arrangement with a brighter chorus.",
})
if err != nil {
log.Fatal(err)
}
_ = task
}Install
gem install runapi-sunorequire "runapi/suno"
client = RunApi::Suno::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY"))
task = client.extend_music.create(
model: "suno-v5",
audio_url: "https://file.runapi.ai/source-audio.mp3",
parameter_mode: "source",
prompt: "Continue the arrangement with a brighter chorus."
)Install
implementation("ai.runapi:runapi-suno")import ai.runapi.suno.SunoClient;
import ai.runapi.suno.types.ExtendMusicParams;
import ai.runapi.core.polling.TaskCreateResponse;
public final class Example {
public static void main(String[] args) {
SunoClient client = SunoClient.builder()
.apiKey(System.getenv("RUNAPI_API_KEY"))
.build();
TaskCreateResponse task = client.extendMusic().create(
ExtendMusicParams.builder()
.model("suno-v5")
.audioUrl("https://file.runapi.ai/source-audio.mp3")
.parameterMode("source")
.prompt("Continue the arrangement with a brighter chorus.")
.build()
);
}
}Install
composer require runapi-ai/suno<?php
require __DIR__ . '/vendor/autoload.php';
use RunApi\Core\ClientOptions;
use RunApi\Suno\SunoClient;
$client = new SunoClient(new ClientOptions(apiKey: getenv('RUNAPI_API_KEY')));
$task = $client->extendMusic->create([
"model" => "suno-v5",
"audio_url" => "https://file.runapi.ai/source-audio.mp3",
"parameter_mode" => "source",
"prompt" => "Continue the arrangement with a brighter chorus."
]);