初始化音频文件

开发中

该接口用于在音频上传完成后，初始化音频片段 (clip)，以便后续用于生成任务。

📅 流程总览

以下流程展示了上传音频到使用的完整步骤，本接口对应 第 5 步。

🔗 接口定义

• 接口地址: https://aiapi.winfull.top/suno/uploads/audio/{id}/initialize-clip
• 请求方式: POST
• 内容类型: application/json

📝 请求参数

Path 参数

参数名	类型	必填	说明
id	string	是	上传任务的唯一标识 ID (从步骤1获取)

Body 参数

参数名	类型	必填	说明
-	object	是	空对象 {}，目前不需要额外参数

Header 参数

参数名	必填	说明	示例
Authorization	是	用于认证的 Bearer Token	Bearer sk-xxxxxxxx

💻 代码示例

curl --location --request POST 'https://aiapi.winfull.top/suno/uploads/audio/AUDIO_ID_HERE/initialize-clip' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{}'

🟢 返回响应

状态码: 200 OK

{
    "clip_id": "05c9b477-4519-4810-9ffa-00580c082067"
}

提示

返回的 clip_id 将用于后续的音乐生成或续写任务。

修改于 2026-01-08