Suno Extend-Music
以异步 Task 提交Extend Music请求。
概览
使用支持的模型提交Extend Music请求。使用返回的 Task ID 查询状态，或提供 callback_url 接收下方列出的投递。
快速开始
- 创建 API Key，并将其设置为 RUNAPI_API_KEY。
- 选择一个支持的模型，并发送与该模型 Schema 匹配的 POST 请求。
- 保存返回的任务 ID，随后轮询到终态，或处理下方列出的回调。
端点
- 基础 URL
https://runapi.ai- API 版本
v1- 身份验证
Authorization: Bearer YOUR_API_TOKEN
支持的模型
打开模型页可查看当前价格、限流和商业使用详情。
请求 Schema
字段和允许的取值取决于所选模型。提供 callback_url 后，它会收到下方列出的 Task 投递。
suno-v420 个字段
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).
可选值:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
可选值: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.
可选值:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v4.520 个字段
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).
可选值:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
可选值: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.
可选值:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v4.5-all20 个字段
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).
可选值:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
可选值: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.
可选值:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v4.5-plus20 个字段
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).
可选值:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
可选值: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.
可选值:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v520 个字段
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).
可选值:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
可选值: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.
可选值:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
suno-v5.520 个字段
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).
可选值:source, custom
persona_idstringPersona ID.
persona_typestringPersona type.
可选值: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.
可选值:male, female
weirdness_constraintnumberWeirdness constraint (0-1).
创建已接受
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}轮询处理中
GET /api/v1/suno/extend_music/:id
响应 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
}响应示例
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}轮询已完成
GET /api/v1/suno/extend_music/:id
响应 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
}响应示例
{
"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"
}轮询失败
GET /api/v1/suno/extend_music/:id
响应 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
}响应示例
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}客户回调：处理中
POST callback_url
响应 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
}响应示例
{
"generation_stage": "text_generated",
"id": "tsk_reference_demo",
"status": "processing"
}客户回调：已完成
POST callback_url
响应 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
}响应示例
{
"audios": [
{
"audio_url": "https://file.runapi.ai/reference-audio.mp3",
"id": "audio_reference"
}
],
"id": "tsk_reference_demo",
"status": "completed"
}客户回调：失败
POST callback_url
响应 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
}响应示例
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}错误
POST /api/v1/suno/extend_music
此响应不包含正文。
错误
GET /api/v1/suno/extend_music/:id
此响应不包含正文。
错误
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"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"
}
}错误
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance"
}
}错误
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"error": {
"code": "api_token_credit_limit_exceeded",
"message": "API key credit limit exceeded"
}
}错误
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"error": {
"code": "request_conflict",
"message": "The request uses features that are not supported for the selected model"
}
}错误
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"error": {
"code": "rate_limited",
"message": "Rate limit reached. Please retry later."
}
}错误
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"error": {
"code": "service_unavailable",
"message": "Service under maintenance, please try again later"
}
}错误
POST /api/v1/suno/extend_music
响应 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
}响应示例
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": {
"code": "timeout_error",
"message": "The request timed out"
}
}错误
GET /api/v1/suno/extend_music/:id
响应 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
}响应示例
{
"error": {
"code": "not_found",
"message": "Task with id 'tsk_reference_demo' not found"
}
}生成的代码示例
直接使用 cURL，或安装所用语言的 SDK。每个示例都会提交本参考中经过验证的请求。
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."}'安装
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."
});安装
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."
)安装
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
}安装
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."
)安装
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()
);
}
}安装
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."
]);