Suno Musik verlängern
Verwende den Extend Music-Endpunkt, um einen asynchronen Task zu erstellen.
Übersicht
Verwende den Extend Music-Endpunkt mit einem unterstützten Modell. Verwende die zurückgegebene Task-ID, um den Zustand abzurufen, oder gib callback_url für die unten dokumentierten Zustellungen an.
Schnellstart
- Erstellen Sie einen API-Schlüssel und setzen Sie ihn als RUNAPI_API_KEY.
- Wählen Sie ein unterstütztes Modell und senden Sie eine POST-Anfrage, deren Body dem Schema dieses Modells entspricht.
- Speichern Sie die zurückgegebene Task-ID und fragen Sie den Status ab, bis ein Endzustand erreicht ist, oder verarbeiten Sie die unten dokumentierten Callbacks.
Endpunkt
- Basis-URL
https://runapi.ai- API-Version
v1- Authentifizierung
Authorization: Bearer YOUR_API_TOKEN
Unterstützte Modelle
Öffnen Sie eine Modellseite für aktuelle Preise, Ratenlimits und Details zur kommerziellen Nutzung.
Anfrage-Schema
Felder und zulässige Werte hängen vom ausgewählten Modell ab. Wenn angegeben, empfängt callback_url die unten dokumentierten Task-Zustellungen.
suno-v420 Felder
audio_idstringQuell-Audio-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_urlstringQuell-Audio-URL zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_weightnumberAudiogewichtung (0–1).
Bereich:0 - 1
callback_urlstringWebhook-URL für asynchrone Benachrichtigungen.
continue_atnumberSekunden in der Quelle, ab denen fortgesetzt werden soll. Im benutzerdefinierten Parametermodus erforderlich.
instrumentalbooleanWenn „true", ohne Gesang generieren.
lyricsstringExakter Liedtext. Nur erlaubt, wenn hochgeladenes Audio im benutzerdefinierten Parametermodus erweitert wird.
Grenzwert:5000
modelstringModell-Slug.
negative_tagsstringZu vermeidende Stile.
parameter_modestringDie Parameter des Quell-Tracks übernehmen (source) oder eigene angeben (custom).
Zulässige Werte:source, custom
persona_idstringPersona-ID.
persona_typestringPersona-Typ.
Zulässige Werte:style, voice
promptstringErweiterungskurzfassung. Kann nicht mit lyrics kombiniert werden.
Grenzwert:5000
stylestringStil-Preset. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:1000
style_weightnumberGewichtung der Stiltreue (0–1).
Bereich:0 - 1
task_idstringQuell-Task-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
titlestringSongtitel. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:80
upload_urlstringURL der hochgeladenen Quellaudio zum Verlängern. Geben Sie eines von task_id, audio_id, audio_url oder upload_url an.
vocal_genderstringVokales Geschlecht.
Zulässige Werte:male, female
weirdness_constraintnumberEinschränkung für Seltsamkeit (0–1).
Bereich:0 - 1
suno-v4.520 Felder
audio_idstringQuell-Audio-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_urlstringQuell-Audio-URL zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_weightnumberAudiogewichtung (0–1).
Bereich:0 - 1
callback_urlstringWebhook-URL für asynchrone Benachrichtigungen.
continue_atnumberSekunden in der Quelle, ab denen fortgesetzt werden soll. Im benutzerdefinierten Parametermodus erforderlich.
instrumentalbooleanWenn „true", ohne Gesang generieren.
lyricsstringExakter Liedtext. Nur erlaubt, wenn hochgeladenes Audio im benutzerdefinierten Parametermodus erweitert wird.
Grenzwert:5000
modelstringModell-Slug.
negative_tagsstringZu vermeidende Stile.
parameter_modestringDie Parameter des Quell-Tracks übernehmen (source) oder eigene angeben (custom).
Zulässige Werte:source, custom
persona_idstringPersona-ID.
persona_typestringPersona-Typ.
Zulässige Werte:style, voice
promptstringErweiterungskurzfassung. Kann nicht mit lyrics kombiniert werden.
Grenzwert:5000
stylestringStil-Preset. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:1000
style_weightnumberGewichtung der Stiltreue (0–1).
Bereich:0 - 1
task_idstringQuell-Task-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
titlestringSongtitel. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:80
upload_urlstringURL der hochgeladenen Quellaudio zum Verlängern. Geben Sie eines von task_id, audio_id, audio_url oder upload_url an.
vocal_genderstringVokales Geschlecht.
Zulässige Werte:male, female
weirdness_constraintnumberEinschränkung für Seltsamkeit (0–1).
Bereich:0 - 1
suno-v4.5-all20 Felder
audio_idstringQuell-Audio-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_urlstringQuell-Audio-URL zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_weightnumberAudiogewichtung (0–1).
Bereich:0 - 1
callback_urlstringWebhook-URL für asynchrone Benachrichtigungen.
continue_atnumberSekunden in der Quelle, ab denen fortgesetzt werden soll. Im benutzerdefinierten Parametermodus erforderlich.
instrumentalbooleanWenn „true", ohne Gesang generieren.
lyricsstringExakter Liedtext. Nur erlaubt, wenn hochgeladenes Audio im benutzerdefinierten Parametermodus erweitert wird.
Grenzwert:5000
modelstringModell-Slug.
negative_tagsstringZu vermeidende Stile.
parameter_modestringDie Parameter des Quell-Tracks übernehmen (source) oder eigene angeben (custom).
Zulässige Werte:source, custom
persona_idstringPersona-ID.
persona_typestringPersona-Typ.
Zulässige Werte:style, voice
promptstringErweiterungskurzfassung. Kann nicht mit lyrics kombiniert werden.
Grenzwert:5000
stylestringStil-Preset. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:1000
style_weightnumberGewichtung der Stiltreue (0–1).
Bereich:0 - 1
task_idstringQuell-Task-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
titlestringSongtitel. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:80
upload_urlstringURL der hochgeladenen Quellaudio zum Verlängern. Geben Sie eines von task_id, audio_id, audio_url oder upload_url an.
vocal_genderstringVokales Geschlecht.
Zulässige Werte:male, female
weirdness_constraintnumberEinschränkung für Seltsamkeit (0–1).
Bereich:0 - 1
suno-v4.5-plus20 Felder
audio_idstringQuell-Audio-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_urlstringQuell-Audio-URL zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_weightnumberAudiogewichtung (0–1).
Bereich:0 - 1
callback_urlstringWebhook-URL für asynchrone Benachrichtigungen.
continue_atnumberSekunden in der Quelle, ab denen fortgesetzt werden soll. Im benutzerdefinierten Parametermodus erforderlich.
instrumentalbooleanWenn „true", ohne Gesang generieren.
lyricsstringExakter Liedtext. Nur erlaubt, wenn hochgeladenes Audio im benutzerdefinierten Parametermodus erweitert wird.
Grenzwert:5000
modelstringModell-Slug.
negative_tagsstringZu vermeidende Stile.
parameter_modestringDie Parameter des Quell-Tracks übernehmen (source) oder eigene angeben (custom).
Zulässige Werte:source, custom
persona_idstringPersona-ID.
persona_typestringPersona-Typ.
Zulässige Werte:style, voice
promptstringErweiterungskurzfassung. Kann nicht mit lyrics kombiniert werden.
Grenzwert:5000
stylestringStil-Preset. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:1000
style_weightnumberGewichtung der Stiltreue (0–1).
Bereich:0 - 1
task_idstringQuell-Task-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
titlestringSongtitel. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:80
upload_urlstringURL der hochgeladenen Quellaudio zum Verlängern. Geben Sie eines von task_id, audio_id, audio_url oder upload_url an.
vocal_genderstringVokales Geschlecht.
Zulässige Werte:male, female
weirdness_constraintnumberEinschränkung für Seltsamkeit (0–1).
Bereich:0 - 1
suno-v520 Felder
audio_idstringQuell-Audio-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_urlstringQuell-Audio-URL zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_weightnumberAudiogewichtung (0–1).
Bereich:0 - 1
callback_urlstringWebhook-URL für asynchrone Benachrichtigungen.
continue_atnumberSekunden in der Quelle, ab denen fortgesetzt werden soll. Im benutzerdefinierten Parametermodus erforderlich.
instrumentalbooleanWenn „true", ohne Gesang generieren.
lyricsstringExakter Liedtext. Nur erlaubt, wenn hochgeladenes Audio im benutzerdefinierten Parametermodus erweitert wird.
Grenzwert:5000
modelstringModell-Slug.
negative_tagsstringZu vermeidende Stile.
parameter_modestringDie Parameter des Quell-Tracks übernehmen (source) oder eigene angeben (custom).
Zulässige Werte:source, custom
persona_idstringPersona-ID.
persona_typestringPersona-Typ.
Zulässige Werte:style, voice
promptstringErweiterungskurzfassung. Kann nicht mit lyrics kombiniert werden.
Grenzwert:5000
stylestringStil-Preset. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:1000
style_weightnumberGewichtung der Stiltreue (0–1).
Bereich:0 - 1
task_idstringQuell-Task-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
titlestringSongtitel. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:80
upload_urlstringURL der hochgeladenen Quellaudio zum Verlängern. Geben Sie eines von task_id, audio_id, audio_url oder upload_url an.
vocal_genderstringVokales Geschlecht.
Zulässige Werte:male, female
weirdness_constraintnumberEinschränkung für Seltsamkeit (0–1).
Bereich:0 - 1
suno-v5.520 Felder
audio_idstringQuell-Audio-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_urlstringQuell-Audio-URL zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
audio_weightnumberAudiogewichtung (0–1).
Bereich:0 - 1
callback_urlstringWebhook-URL für asynchrone Benachrichtigungen.
continue_atnumberSekunden in der Quelle, ab denen fortgesetzt werden soll. Im benutzerdefinierten Parametermodus erforderlich.
instrumentalbooleanWenn „true", ohne Gesang generieren.
lyricsstringExakter Liedtext. Nur erlaubt, wenn hochgeladenes Audio im benutzerdefinierten Parametermodus erweitert wird.
Grenzwert:5000
modelstringModell-Slug.
negative_tagsstringZu vermeidende Stile.
parameter_modestringDie Parameter des Quell-Tracks übernehmen (source) oder eigene angeben (custom).
Zulässige Werte:source, custom
persona_idstringPersona-ID.
persona_typestringPersona-Typ.
Zulässige Werte:style, voice
promptstringErweiterungskurzfassung. Kann nicht mit lyrics kombiniert werden.
Grenzwert:5000
stylestringStil-Preset. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:1000
style_weightnumberGewichtung der Stiltreue (0–1).
Bereich:0 - 1
task_idstringQuell-Task-ID zum Verlängern. Geben Sie einen der folgenden Werte an: task_id, audio_id, audio_url oder upload_url.
titlestringSongtitel. Im benutzerdefinierten Parametermodus erforderlich.
Grenzwert:80
upload_urlstringURL der hochgeladenen Quellaudio zum Verlängern. Geben Sie eines von task_id, audio_id, audio_url oder upload_url an.
vocal_genderstringVokales Geschlecht.
Zulässige Werte:male, female
weirdness_constraintnumberEinschränkung für Seltsamkeit (0–1).
Bereich:0 - 1
Annahme erstellen
POST /api/v1/suno/extend_music
Antwort-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
}Antwortbeispiel
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}Abfrage wird verarbeitet
GET /api/v1/suno/extend_music/:id
Antwort-Schema
{
"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
}Antwortbeispiel
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}Abfrage abgeschlossen
GET /api/v1/suno/extend_music/:id
Antwort-Schema
{
"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
}Antwortbeispiel
{
"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"
}Abfrage fehlgeschlagen
GET /api/v1/suno/extend_music/:id
Antwort-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
}Antwortbeispiel
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}Kunden-Callback: wird verarbeitet
POST callback_url
Antwort-Schema
{
"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
}Antwortbeispiel
{
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}Kunden-Callback: abgeschlossen
POST callback_url
Antwort-Schema
{
"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
}Antwortbeispiel
{
"audios": [
{
"audio_url": "https://file.runapi.ai/reference-audio.mp3",
"id": "audio_reference"
}
],
"id": "tsk_reference_demo",
"status": "completed"
}Kunden-Callback: fehlgeschlagen
POST callback_url
Antwort-Schema
{
"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
}Antwortbeispiel
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "Authentication required"
}Fehler
GET /api/v1/suno/extend_music/:id
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "Authentication required"
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"oneOf": [
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
},
{
"properties": {
"error": {
"description": "Menschenlesbare Validierungszusammenfassung.",
"type": "string"
},
"errors": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Validierungsmeldungen nach öffentlichem Anforderungsfeld gegliedert, mit einem Array menschenlesbarer Zeichenketten für jedes Feld.",
"type": "object"
}
},
"required": [
"error",
"errors"
],
"type": "object",
"unevaluatedProperties": false
}
]
}Antwortbeispiel
{
"error": "model must be one of: suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5"
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "Insufficient balance"
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "API key credit limit exceeded"
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "The request uses features that are not supported for the selected model"
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "Rate limit reached. Please retry later."
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "Service under maintenance, please try again later"
}Fehler
POST /api/v1/suno/extend_music
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "The request timed out"
}Fehler
GET /api/v1/suno/extend_music/:id
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Antwortbeispiel
{
"error": "Task with id 'tsk_reference_demo' not found"
}Generierte Code-Beispiele
Verwende cURL direkt oder installiere ein SDK für deine Programmiersprache. Jedes Beispiel übermittelt die in dieser Referenz gezeigte validierte Anfrage.
Installieren
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"
)