请求上传授权

概览

• 简介: 开发中 POST https://api.winfull.cloud-ip.cc/suno/uploads/audio ┌─────────────────────────────────────────────────────────────────┐ │ 第1步: 请求上传授权 │ │ POST /suno/uploads/audio │ │ ↓ 返回: upload_id, upload_url │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 第2步: 上传文件到S3 (客户端直连，不经过API) │ │ PUT {upload_url} │ │ ↓ 上传音频文件 │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 第3步: 报告上传完毕 │ │ POST /suno/uploads/audio/{id}/upload-finish │ │ ↓ 通知服务器文件已上传 │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 第4步: 轮询查询上传状态 (直到状态为 completed) │ │ GET /suno/uploads/audio/{id} │ │ ↓ 每2-3秒查询一次 │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 第5步: 初始化音频clip │ │ POST /suno/uploads/audio/{id}/initialize-clip │ │ ↓ 返回: clip_id │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 第6步: 使用clip_id创建续写任务 │ │ POST /suno/submit/music │ │ ↓ 返回: task_id (开始计费) │ └─────────────────────────────────────────────────────────────────┘

认证

• Header: Authorization: Bearer <token>

请求参数

• Header: Authorization: Bearer <token>
• Body 类型: application/json

{
    "extension": "mp3"
}

请求示例

curl --location --request POST 'https://api.winfull.cloud-ip.cc/suno/uploads/audio' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "extension": "mp3"
}'

返回示例

🟢200成功 示例

{
    "id": "f208ab1f-e93a-4417-b089-e7fc38b50268",
    "url": "https://suno-uploads.s3.amazonaws.com/",
    "fields": {
        "Content-Type": "audio/mpeg",
        "key": "raw_uploads/f208ab1f-e93a-4417-b089-e7fc38b50268.mp3",
        "AWSAccessKeyId": "AKIA2V4GXGDKLZ43MUG7",
        "policy": "eyJleHBpcmF0aW9uIjogIjIwMjYtMDEtMDZUMDM6Mjg6MjlaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDUyNDI4ODAwMF0sIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJhdWRpby9tcGVnIl0sIHsiYnVja2V0IjogInN1bm8tdXBsb2FkcyJ9LCB7ImtleSI6ICJyYXdfdXBsb2Fkcy9mMjA4YWIxZi1lOTNhLTQ0MTctYjA4OS1lN2ZjMzhiNTAyNjgubXAzIn1dfQ==",
        "signature": "tevxOl3SW28afyLyzObeCYzIvWI="
    },
    "is_file_uploaded": false
}

最后更新：2026-01-08 05:21:57