说明文件

文件上传

音频的上传需要严格遵守5个步骤才可以使用：

获取上传地址

上传音频

报告上传完毕

查询上传状态

音频初始化

获取文件上传地址

请求：

响应

{
    "id": "13f0cf21-7dfd-45e3-a804-808973378f77",
    "url": "https://suno-uploads.s3.amazonaws.com/",
    "fields": {
        "AWSAccessKeyId": "AKIA2V4GXGDKJMTPWLXO",
        "Content-Type": "audio/mpeg",
        "key": "raw_uploads/13f0cf21-7dfd-45e3-a804-808973378f77.mp3",
        "policy": "eyJleHBpcmF0aW9uIjogIjIwMjUtMDgtMjBUMTY6MzY6MTZaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1sYW5nZSIsIDAsIDUyNDI4ODAwMF0sIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJhdWRpby9tcGVnIl0sIHsiYnVja2V0IjogInN1bm8tdXBsb2FkcyJ9LCB7ImtleSI6ICJyYXdfdXBsb2Fkcy8xM2YwY2YyMS03ZGZkLTQ1ZTMtYTgwNC04MDg5NzMzNzhmNzcubXAzIn1dfQ==",
        "signature": "F+ByARNEhXNv+ODC86ykLjdZiFg="
    },
    "is_file_uploaded": false
}

⚠️：你需要记住ID，后续需要使用到它

上传音频

根据第一个接口获取到的上传地址以及鉴权字段，我们对音频进行上传, 注意参数需要填写正确。

报告上传状态

当第二部上传完毕后，你需要通知我们音频以及上传完毕, URL中的task_id是第一步响应中获取到的ID，当状态码返回200,即为成功。

查询上传状态

报告完状态后，获取上传的状态, 当响应的status为complete时，即为成功

请求：

响应：

{
    "has_vocal": false,
    "id": "f2982a08-689c-43c3-9bd3-c815979d10dc",
    "image_url": "https://cdn2.suno.ai/image_cdd95545-5fdd-421e-91c2-e9da04adde59.jpeg",
    "s3_id": "cdd95545-5fdd-421e-91c2-e9da04adde59",
    "status": "complete",
    "title": "you_mp3_name"
}

音频初始化

最后一步，初始化音频。这一步可以获取到clip_id，之后你可以通过这个clip_id来去修改/创建音频了。

请求：

响应：

{
    "clip_id": "1925d489-8ccd-4ce3-89fd-dfa5f33ae144"
}

文件上传#

获取文件上传地址#

请求：#

响应#

上传音频#

报告上传状态#

查询上传状态#

请求：#

响应：#

音频初始化#

请求：#

响应：#

文件上传

获取文件上传地址

请求：

响应

上传音频

报告上传状态

查询上传状态

请求：

响应：

音频初始化

请求：

响应：