Studio batch edit
curl --request POST \
--url https://api.mountsea.ai/suno/v2/studio/edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"clip_id": "<string>",
"ops": [
{
"start_s": 123,
"end_s": 123,
"insert_at_s": 123,
"at_s": 123,
"sections": [
{
"start_s": 1,
"end_s": 1
}
],
"close_gap": true,
"rate": 1.1,
"duration_s": 123
}
],
"title": "<string>"
}
'import requests
url = "https://api.mountsea.ai/suno/v2/studio/edit"
payload = {
"clip_id": "<string>",
"ops": [
{
"start_s": 123,
"end_s": 123,
"insert_at_s": 123,
"at_s": 123,
"sections": [
{
"start_s": 1,
"end_s": 1
}
],
"close_gap": True,
"rate": 1.1,
"duration_s": 123
}
],
"title": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
clip_id: '<string>',
ops: [
{
start_s: 123,
end_s: 123,
insert_at_s: 123,
at_s: 123,
sections: [{start_s: 1, end_s: 1}],
close_gap: true,
rate: 1.1,
duration_s: 123
}
],
title: '<string>'
})
};
fetch('https://api.mountsea.ai/suno/v2/studio/edit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mountsea.ai/suno/v2/studio/edit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'clip_id' => '<string>',
'ops' => [
[
'start_s' => 123,
'end_s' => 123,
'insert_at_s' => 123,
'at_s' => 123,
'sections' => [
[
'start_s' => 1,
'end_s' => 1
]
],
'close_gap' => true,
'rate' => 1.1,
'duration_s' => 123
]
],
'title' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mountsea.ai/suno/v2/studio/edit"
payload := strings.NewReader("{\n \"clip_id\": \"<string>\",\n \"ops\": [\n {\n \"start_s\": 123,\n \"end_s\": 123,\n \"insert_at_s\": 123,\n \"at_s\": 123,\n \"sections\": [\n {\n \"start_s\": 1,\n \"end_s\": 1\n }\n ],\n \"close_gap\": true,\n \"rate\": 1.1,\n \"duration_s\": 123\n }\n ],\n \"title\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mountsea.ai/suno/v2/studio/edit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"clip_id\": \"<string>\",\n \"ops\": [\n {\n \"start_s\": 123,\n \"end_s\": 123,\n \"insert_at_s\": 123,\n \"at_s\": 123,\n \"sections\": [\n {\n \"start_s\": 1,\n \"end_s\": 1\n }\n ],\n \"close_gap\": true,\n \"rate\": 1.1,\n \"duration_s\": 123\n }\n ],\n \"title\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mountsea.ai/suno/v2/studio/edit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"clip_id\": \"<string>\",\n \"ops\": [\n {\n \"start_s\": 123,\n \"end_s\": 123,\n \"insert_at_s\": 123,\n \"at_s\": 123,\n \"sections\": [\n {\n \"start_s\": 1,\n \"end_s\": 1\n }\n ],\n \"close_gap\": true,\n \"rate\": 1.1,\n \"duration_s\": 123\n }\n ],\n \"title\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}Studio
Studio 批量编辑
一次导出内顺序执行多项时间线操作
POST
/
suno
/
v2
/
studio
/
edit
Studio batch edit
curl --request POST \
--url https://api.mountsea.ai/suno/v2/studio/edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"clip_id": "<string>",
"ops": [
{
"start_s": 123,
"end_s": 123,
"insert_at_s": 123,
"at_s": 123,
"sections": [
{
"start_s": 1,
"end_s": 1
}
],
"close_gap": true,
"rate": 1.1,
"duration_s": 123
}
],
"title": "<string>"
}
'import requests
url = "https://api.mountsea.ai/suno/v2/studio/edit"
payload = {
"clip_id": "<string>",
"ops": [
{
"start_s": 123,
"end_s": 123,
"insert_at_s": 123,
"at_s": 123,
"sections": [
{
"start_s": 1,
"end_s": 1
}
],
"close_gap": True,
"rate": 1.1,
"duration_s": 123
}
],
"title": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
clip_id: '<string>',
ops: [
{
start_s: 123,
end_s: 123,
insert_at_s: 123,
at_s: 123,
sections: [{start_s: 1, end_s: 1}],
close_gap: true,
rate: 1.1,
duration_s: 123
}
],
title: '<string>'
})
};
fetch('https://api.mountsea.ai/suno/v2/studio/edit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mountsea.ai/suno/v2/studio/edit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'clip_id' => '<string>',
'ops' => [
[
'start_s' => 123,
'end_s' => 123,
'insert_at_s' => 123,
'at_s' => 123,
'sections' => [
[
'start_s' => 1,
'end_s' => 1
]
],
'close_gap' => true,
'rate' => 1.1,
'duration_s' => 123
]
],
'title' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mountsea.ai/suno/v2/studio/edit"
payload := strings.NewReader("{\n \"clip_id\": \"<string>\",\n \"ops\": [\n {\n \"start_s\": 123,\n \"end_s\": 123,\n \"insert_at_s\": 123,\n \"at_s\": 123,\n \"sections\": [\n {\n \"start_s\": 1,\n \"end_s\": 1\n }\n ],\n \"close_gap\": true,\n \"rate\": 1.1,\n \"duration_s\": 123\n }\n ],\n \"title\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mountsea.ai/suno/v2/studio/edit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"clip_id\": \"<string>\",\n \"ops\": [\n {\n \"start_s\": 123,\n \"end_s\": 123,\n \"insert_at_s\": 123,\n \"at_s\": 123,\n \"sections\": [\n {\n \"start_s\": 1,\n \"end_s\": 1\n }\n ],\n \"close_gap\": true,\n \"rate\": 1.1,\n \"duration_s\": 123\n }\n ],\n \"title\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mountsea.ai/suno/v2/studio/edit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"clip_id\": \"<string>\",\n \"ops\": [\n {\n \"start_s\": 123,\n \"end_s\": 123,\n \"insert_at_s\": 123,\n \"at_s\": 123,\n \"sections\": [\n {\n \"start_s\": 1,\n \"end_s\": 1\n }\n ],\n \"close_gap\": true,\n \"rate\": 1.1,\n \"duration_s\": 123\n }\n ],\n \"title\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}按顺序执行 crop / remove / duplicate / split / reverse / fade / speed,最后一次导出。通过 查询任务状态 轮询至
属于 Studio 编辑。每个 op 的秒数相对「已执行完前面 ops 之后」的时间线。
支持的
success。
通常免费(0 积分,以
conf_task_policy 为准)。不要把 addSection / replace 写进 ops — 请走独立接口。参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
clip_id | string | 是 | 源 clip |
ops | array | 是 | 1~20 条操作(见下) |
title | string | 否 | 最终导出标题 |
beat | object | 否 | 可选节拍器导出(enabled,可选 bpm / time_signature)。不传则保持旧行为 — 见 Studio 编辑 |
支持的 ops[].op
| op | 含义 | 关键字段 |
|---|---|---|
crop | 只保留区间 | start_s, end_s |
removeSection | 删除一段或多段 | sections[],可选 close_gap(默认 true) |
duplicate | 复制选区 | start_s, end_s,可选 insert_at_s |
split | 在时间点切开 | at_s |
reverse | 倒放选区或整曲 | 可选成对 start_s / end_s;都省略=整曲 |
fadeIn | 淡入 | start_s,可选 end_s 或 duration_s(默认约 2s) |
fadeOut | 淡出 | start_s,可选 end_s(默认到结尾) |
setSpeed | 相对原曲绝对倍率 | rate(0.5~2.0),可选成对 start_s / end_s |
写 ops 建议
- 先
crop/removeSection再fade*/setSpeed。 - 改变总时长的 op 之后,后续秒数按新长度估算。
fadeOut.start_s不能超过当前剩余时长。- 一次
edit内做完再导出,避免连环锁。
示例
curl -X POST https://api.mountsea.ai/suno/v2/studio/edit \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"clip_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"title": "精修后的歌",
"ops": [
{ "op": "crop", "start_s": 10, "end_s": 100 },
{ "op": "removeSection", "sections": [{ "start_s": 40, "end_s": 48 }], "close_gap": true },
{ "op": "setSpeed", "start_s": 50, "end_s": 70, "rate": 1.1 },
{ "op": "fadeOut", "start_s": 85 }
]
}'
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
响应
201 - application/json
task id. Use this id to query task status.
示例:
"15c257ff-43f7-4678-bd41-202ad6b8488b"
⌘I