音乐生成 · 上传参考音频

提交可访问的音频地址并返回可用于后续创作的音频 ID。

基本信息

字段内容
应用编码music_generation
API 编码upload_audio
请求方式POST
请求路径/api/v1/apps/music_generation/upload_audio
调用模式同步

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

业务参数

参数类型必填默认值可选值 / 范围示例说明
audio_urlstring是--https://example.com/ref.mp3可公开访问的音频文件 URL,用于生成后续创作需要的音频 ID。

响应说明

同步返回处理结果。媒体类结果可能包含 audio_url、video_url、file_url、image_url、audio_id、persona_id 等字段,具体以接口实际结果为准。

成功示例

{
    "code": 1,
    "msg": "success",
    "data": {
        "result": {
            "status": "completed",
            "audio_id": "audio_xxxxxxxxxxxx",
            "audio_url": "https://example.com/music/reference.mp3",
            "title": "reference_audio",
            "duration": 198,
            "data": {
                "audio_id": "audio_xxxxxxxxxxxx",
                "audio_url": "https://example.com/music/reference.mp3",
                "duration": 198
            }
        },
        "usage": {
            "points_cost": 13,
            "actual_points": 13
        }
    }
}

失败示例

{
    "code": 0,
    "msg": "任务处理失败,请稍后重试",
    "data": null
}

同类文章