上传 Session Item - MountSea API

curl --request POST \ --url https://api.mountsea.ai/suno/v2/audio/upload/session/item \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "sessionId": "e3f2c1a0-1234-5678-abcd-000000000000", "audioUrl": "https://example.com/audio.mp3" } '

POST

suno

audio

upload

session

item

upload one audio to the session-bound account

curl --request POST \
  --url https://api.mountsea.ai/suno/v2/audio/upload/session/item \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sessionId": "e3f2c1a0-1234-5678-abcd-000000000000",
  "audioUrl": "https://example.com/audio.mp3"
}
'

{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}

使用准备上传 Session 绑定的账号上传单个音频文件。

异步任务 — 返回 taskId。用 item 的 taskId 轮询查询任务状态获取 clip 详情。成功后 clip ID 会自动追加到 session 的 audioIds。

字段	类型	必填	说明
`sessionId`	string (UUID)	是	第 1 步返回的 ID
`audioUrl`	string (URL)	是	可公网下载的音频 URL

同一 sessionId 可并发提交多个 item，仍共用同一账号。

属于批量上传 Session 流程。批量完成后用 sessionId（非 item 的 taskId）轮询获取全部 audioIds。

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

sessionId

string<uuid>

必填

uploadSession/prepare 返回的 sessionId

示例:

"e3f2c1a0-1234-5678-abcd-000000000000"

audioUrl

string<uri>

必填

要上传的音频 URL（可公网访问）

示例:

"https://example.com/audio.mp3"

响应

201 - application/json

taskId

string

必填

task id. Use this id to query task status.

示例:

"15c257ff-43f7-4678-bd41-202ad6b8488b"