Suno muziek uitbreiden
Gebruik het extend music-eindpunt om een asynchrone Task te maken.
Overzicht
Gebruik het extend music-eindpunt met een ondersteund model. Gebruik de geretourneerde Task ID om de status op te halen, of geef callback_url op voor de hieronder gedocumenteerde leveringen.
Snelstart
- Maak een API-sleutel aan en stel deze in als RUNAPI_API_KEY.
- Kies een ondersteund model en stuur een POST-verzoek waarvan de body overeenkomt met het schema van dat model.
- Sla de geretourneerde taak-ID op en poll vervolgens totdat een eindstatus is bereikt, of verwerk de hieronder gedocumenteerde callbacks.
Eindpunt
- Basis-URL
https://runapi.ai- API-versie
v1- Authenticatie
Authorization: Bearer YOUR_API_TOKEN
Ondersteunde modellen
Open een modelpagina voor actuele prijzen, snelheidslimieten en details over commercieel gebruik.
Verzoekschema
Velden en toegestane waarden zijn afhankelijk van het geselecteerde model. Indien opgegeven, ontvangt callback_url de hieronder gedocumenteerde taakaflevering.
suno-v420 velden
audio_idstringBrongeluid-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_urlstringBrongeluid-URL om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_weightnumberAudiogewicht (0-1).
Bereik:0 - 1
callback_urlstringWebhook-URL voor asynchrone meldingen.
continue_atnumberSeconden in de bron om verder te gaan. Vereist in de modus voor aangepaste parameters.
instrumentalbooleanIndien true, genereer zonder vocalen.
lyricsstringExacte songteksten. Alleen toegestaan bij het uitbreiden van geüploade audio in de aangepaste parametermodus.
Grens:5000
modelstringModel-slug.
negative_tagsstringTe vermijden stijlen.
parameter_modestringNeem de parameters van het bronspoor over (source) of geef aangepaste parameters op (custom).
Toegestane waarden:source, custom
persona_idstringPersona-ID.
persona_typestringType persona.
Toegestane waarden:style, voice
promptstringKorte uitbreidingsbeschrijving. Kan niet worden gecombineerd met songteksten.
Grens:5000
stylestringStijlpreset. Vereist in de modus voor aangepaste parameters.
Grens:1000
style_weightnumberGewicht voor stijlnaleving (0-1).
Bereik:0 - 1
task_idstringBrontask-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
titlestringSongtitel. Vereist in de modus voor aangepaste parameters.
Grens:80
upload_urlstringGeüploade bron-audio-URL om uit te breiden. Geef één van task_id, audio_id, audio_url of upload_url op.
vocal_genderstringVocaal geslacht.
Toegestane waarden:male, female
weirdness_constraintnumberVreemdheidsbeperking (0-1).
Bereik:0 - 1
suno-v4.520 velden
audio_idstringBrongeluid-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_urlstringBrongeluid-URL om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_weightnumberAudiogewicht (0-1).
Bereik:0 - 1
callback_urlstringWebhook-URL voor asynchrone meldingen.
continue_atnumberSeconden in de bron om verder te gaan. Vereist in de modus voor aangepaste parameters.
instrumentalbooleanIndien true, genereer zonder vocalen.
lyricsstringExacte songteksten. Alleen toegestaan bij het uitbreiden van geüploade audio in de aangepaste parametermodus.
Grens:5000
modelstringModel-slug.
negative_tagsstringTe vermijden stijlen.
parameter_modestringNeem de parameters van het bronspoor over (source) of geef aangepaste parameters op (custom).
Toegestane waarden:source, custom
persona_idstringPersona-ID.
persona_typestringType persona.
Toegestane waarden:style, voice
promptstringKorte uitbreidingsbeschrijving. Kan niet worden gecombineerd met songteksten.
Grens:5000
stylestringStijlpreset. Vereist in de modus voor aangepaste parameters.
Grens:1000
style_weightnumberGewicht voor stijlnaleving (0-1).
Bereik:0 - 1
task_idstringBrontask-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
titlestringSongtitel. Vereist in de modus voor aangepaste parameters.
Grens:80
upload_urlstringGeüploade bron-audio-URL om uit te breiden. Geef één van task_id, audio_id, audio_url of upload_url op.
vocal_genderstringVocaal geslacht.
Toegestane waarden:male, female
weirdness_constraintnumberVreemdheidsbeperking (0-1).
Bereik:0 - 1
suno-v4.5-all20 velden
audio_idstringBrongeluid-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_urlstringBrongeluid-URL om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_weightnumberAudiogewicht (0-1).
Bereik:0 - 1
callback_urlstringWebhook-URL voor asynchrone meldingen.
continue_atnumberSeconden in de bron om verder te gaan. Vereist in de modus voor aangepaste parameters.
instrumentalbooleanIndien true, genereer zonder vocalen.
lyricsstringExacte songteksten. Alleen toegestaan bij het uitbreiden van geüploade audio in de aangepaste parametermodus.
Grens:5000
modelstringModel-slug.
negative_tagsstringTe vermijden stijlen.
parameter_modestringNeem de parameters van het bronspoor over (source) of geef aangepaste parameters op (custom).
Toegestane waarden:source, custom
persona_idstringPersona-ID.
persona_typestringType persona.
Toegestane waarden:style, voice
promptstringKorte uitbreidingsbeschrijving. Kan niet worden gecombineerd met songteksten.
Grens:5000
stylestringStijlpreset. Vereist in de modus voor aangepaste parameters.
Grens:1000
style_weightnumberGewicht voor stijlnaleving (0-1).
Bereik:0 - 1
task_idstringBrontask-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
titlestringSongtitel. Vereist in de modus voor aangepaste parameters.
Grens:80
upload_urlstringGeüploade bron-audio-URL om uit te breiden. Geef één van task_id, audio_id, audio_url of upload_url op.
vocal_genderstringVocaal geslacht.
Toegestane waarden:male, female
weirdness_constraintnumberVreemdheidsbeperking (0-1).
Bereik:0 - 1
suno-v4.5-plus20 velden
audio_idstringBrongeluid-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_urlstringBrongeluid-URL om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_weightnumberAudiogewicht (0-1).
Bereik:0 - 1
callback_urlstringWebhook-URL voor asynchrone meldingen.
continue_atnumberSeconden in de bron om verder te gaan. Vereist in de modus voor aangepaste parameters.
instrumentalbooleanIndien true, genereer zonder vocalen.
lyricsstringExacte songteksten. Alleen toegestaan bij het uitbreiden van geüploade audio in de aangepaste parametermodus.
Grens:5000
modelstringModel-slug.
negative_tagsstringTe vermijden stijlen.
parameter_modestringNeem de parameters van het bronspoor over (source) of geef aangepaste parameters op (custom).
Toegestane waarden:source, custom
persona_idstringPersona-ID.
persona_typestringType persona.
Toegestane waarden:style, voice
promptstringKorte uitbreidingsbeschrijving. Kan niet worden gecombineerd met songteksten.
Grens:5000
stylestringStijlpreset. Vereist in de modus voor aangepaste parameters.
Grens:1000
style_weightnumberGewicht voor stijlnaleving (0-1).
Bereik:0 - 1
task_idstringBrontask-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
titlestringSongtitel. Vereist in de modus voor aangepaste parameters.
Grens:80
upload_urlstringGeüploade bron-audio-URL om uit te breiden. Geef één van task_id, audio_id, audio_url of upload_url op.
vocal_genderstringVocaal geslacht.
Toegestane waarden:male, female
weirdness_constraintnumberVreemdheidsbeperking (0-1).
Bereik:0 - 1
suno-v520 velden
audio_idstringBrongeluid-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_urlstringBrongeluid-URL om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_weightnumberAudiogewicht (0-1).
Bereik:0 - 1
callback_urlstringWebhook-URL voor asynchrone meldingen.
continue_atnumberSeconden in de bron om verder te gaan. Vereist in de modus voor aangepaste parameters.
instrumentalbooleanIndien true, genereer zonder vocalen.
lyricsstringExacte songteksten. Alleen toegestaan bij het uitbreiden van geüploade audio in de aangepaste parametermodus.
Grens:5000
modelstringModel-slug.
negative_tagsstringTe vermijden stijlen.
parameter_modestringNeem de parameters van het bronspoor over (source) of geef aangepaste parameters op (custom).
Toegestane waarden:source, custom
persona_idstringPersona-ID.
persona_typestringType persona.
Toegestane waarden:style, voice
promptstringKorte uitbreidingsbeschrijving. Kan niet worden gecombineerd met songteksten.
Grens:5000
stylestringStijlpreset. Vereist in de modus voor aangepaste parameters.
Grens:1000
style_weightnumberGewicht voor stijlnaleving (0-1).
Bereik:0 - 1
task_idstringBrontask-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
titlestringSongtitel. Vereist in de modus voor aangepaste parameters.
Grens:80
upload_urlstringGeüploade bron-audio-URL om uit te breiden. Geef één van task_id, audio_id, audio_url of upload_url op.
vocal_genderstringVocaal geslacht.
Toegestane waarden:male, female
weirdness_constraintnumberVreemdheidsbeperking (0-1).
Bereik:0 - 1
suno-v5.520 velden
audio_idstringBrongeluid-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_urlstringBrongeluid-URL om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
audio_weightnumberAudiogewicht (0-1).
Bereik:0 - 1
callback_urlstringWebhook-URL voor asynchrone meldingen.
continue_atnumberSeconden in de bron om verder te gaan. Vereist in de modus voor aangepaste parameters.
instrumentalbooleanIndien true, genereer zonder vocalen.
lyricsstringExacte songteksten. Alleen toegestaan bij het uitbreiden van geüploade audio in de aangepaste parametermodus.
Grens:5000
modelstringModel-slug.
negative_tagsstringTe vermijden stijlen.
parameter_modestringNeem de parameters van het bronspoor over (source) of geef aangepaste parameters op (custom).
Toegestane waarden:source, custom
persona_idstringPersona-ID.
persona_typestringType persona.
Toegestane waarden:style, voice
promptstringKorte uitbreidingsbeschrijving. Kan niet worden gecombineerd met songteksten.
Grens:5000
stylestringStijlpreset. Vereist in de modus voor aangepaste parameters.
Grens:1000
style_weightnumberGewicht voor stijlnaleving (0-1).
Bereik:0 - 1
task_idstringBrontask-ID om te verlengen. Geef een van task_id, audio_id, audio_url of upload_url op.
titlestringSongtitel. Vereist in de modus voor aangepaste parameters.
Grens:80
upload_urlstringGeüploade bron-audio-URL om uit te breiden. Geef één van task_id, audio_id, audio_url of upload_url op.
vocal_genderstringVocaal geslacht.
Toegestane waarden:male, female
weirdness_constraintnumberVreemdheidsbeperking (0-1).
Bereik:0 - 1
Acceptatie aanmaken
POST /api/v1/suno/extend_music
Responsschema
{
"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
}Responsvoorbeeld
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}Pollen bezig
GET /api/v1/suno/extend_music/:id
Responsschema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string",
"x-runapi-generated-media": true
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"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
}Responsvoorbeeld
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}Pollen voltooid
GET /api/v1/suno/extend_music/:id
Responsschema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string",
"x-runapi-generated-media": true
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"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
}Responsvoorbeeld
{
"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"
}Pollen mislukt
GET /api/v1/suno/extend_music/:id
Responsschema
{
"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
}Responsvoorbeeld
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}Callback van klant: wordt verwerkt
POST callback_url
Responsschema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string",
"x-runapi-generated-media": true
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"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
}Responsvoorbeeld
{
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}Callback van klant: voltooid
POST callback_url
Responsschema
{
"properties": {
"audios": {
"items": {
"properties": {
"audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"duration": {
"type": "number"
},
"id": {
"type": "string"
},
"image_url": {
"type": "string",
"x-runapi-generated-media": true
},
"lyrics": {
"type": "string"
},
"model_name": {
"type": "string"
},
"stream_audio_url": {
"type": "string",
"x-runapi-generated-media": true
},
"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
}Responsvoorbeeld
{
"audios": [
{
"audio_url": "https://file.runapi.ai/reference-audio.mp3",
"id": "audio_reference"
}
],
"id": "tsk_reference_demo",
"status": "completed"
}Callback van klant: mislukt
POST callback_url
Responsschema
{
"properties": {
"error": {
"oneOf": [
{
"type": "string"
},
{
"properties": {
"code": {
"type": "string"
},
"limit_cents": {
"type": "integer"
},
"message": {
"type": "string"
},
"reset_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"used_cents": {
"type": "integer"
},
"window": {
"enum": [
"1h",
"1d",
"7d",
"daily",
"weekly",
"monthly",
"lifetime"
],
"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
}Responsvoorbeeld
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "Authentication required"
}Fouten
GET /api/v1/suno/extend_music/:id
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "Authentication required"
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"oneOf": [
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
},
{
"properties": {
"error": {
"description": "Leesbare validatiesamenvatting.",
"type": "string"
},
"errors": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Validatieberichten gekoppeld aan het openbare aanvraagveld, met een reeks leesbare tekenreeksen per veld.",
"type": "object"
}
},
"required": [
"error",
"errors"
],
"type": "object",
"unevaluatedProperties": false
}
]
}Responsvoorbeeld
{
"error": "model must be one of: suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5"
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "Insufficient balance"
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "API key credit limit exceeded"
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "The request uses features that are not supported for the selected model"
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "Rate limit reached. Please retry later."
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "Service under maintenance, please try again later"
}Fouten
POST /api/v1/suno/extend_music
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "The request timed out"
}Fouten
GET /api/v1/suno/extend_music/:id
Responsschema
{
"properties": {
"error": {
"description": "Leesbare foutmelding.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Responsvoorbeeld
{
"error": "Task with id 'tsk_reference_demo' not found"
}Gegenereerde codevoorbeelden
Gebruik cURL rechtstreeks, of installeer een SDK voor uw taal. Elk voorbeeld dient het gevalideerde verzoek in dat in deze referentie wordt getoond.
Installeren
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",
upload_url="https://cdn.runapi.ai/public/samples/music.mp3",
parameter_mode="custom",
instrumental=False,
prompt="Continue the arrangement with a brighter chorus.",
style="Acoustic pop with warm piano.",
title="Brighter Chorus",
continue_at=60,
persona_id="persona_reference",
persona_type="style"
)