剪辑与改造 | ToAPIs Documentation

POST

/v1/music/generations/crop

国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。

剪辑与改造类操作，全部以已有任务为源：

POST https://toapis.com/v1/music/generations/{operation}

modelstring请求体必填

固定 "suno"

task_idstring请求体必填

源任务 ID（本平台 tsk_aud_ ID)

audio_indexnumber请求体

源曲目序号

时间段剪辑($0.008 / 次）

operation	说明	额外必填
`crop`	截取时间段保留	`start_s`、`end_s`
`removeSection`	删除时间段	`start_s`、`end_s`

curl --request POST \
  --url https://toapis.com/v1/music/generations/crop \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_id":"tsk_aud_xxx","audio_index":1,"start_s":10,"end_s":40}'

淡入淡出($0.008 / 次）

operation	说明	额外必填
`fadeIn`	开头淡入	`duration_s`
`fadeOut`	结尾淡出	`duration_s`

adjustSpeed — 变速($0.024)

speednumber请求体必填

速度倍率，如 0.8 / 1.25

keep_pitchboolean请求体

变速时保持音调

换写与重制

replaceMusic — 片段换写($0.05,Max $0.10)

start_snumber请求体必填

换写起点（秒）

end_snumber请求体必填

换写终点（秒）

infill_lyricsstring请求体

该片段的新歌词

max_modeboolean请求体

Max 档（本操作无 custom，直接生效）

sample — 采样重编排($0.05,Max $0.10)

task_id 必须是 uploadTask 产物，其他源会被拒绝。

start_snumber请求体必填

采样起点（秒）

end_snumber请求体必填

采样终点（秒）

gpt_descriptionstring请求体

重编排描述（custom=false 时必填）

coverSong — 翻唱($0.05,Max $0.10)

gpt_descriptionstring请求体

目标风格描述（custom=false 时必填）

customboolean请求体

promptstring请求体

custom=true 时的歌词

stylestring请求体

目标风格

remaster — 音质重制($0.05)

variation_categorystring请求体

重制取向（可选）

mashup — 混编($0.05,Max $0.10)

task_idsarray请求体必填

恰好 2 个源任务 ID

audio_indexesarray请求体

各源任务的曲目序号

gpt_descriptionstring请求体

混编风格描述（custom=false 时必填）

curl --request POST \
  --url https://toapis.com/v1/music/generations/mashup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_ids":["tsk_aud_aaa","tsk_aud_bbb"],"gpt_description":"blend into seamless lo-fi"}'

concat — 拼接($0.004)

拼接 extend 产生的分段为完整曲目。

task_idstring请求体必填

extend 源任务 ID

Response

task_idstring

新任务 ID

statusstring

submitted