人声分离
curl --request POST \
--url https://api.ephone.ai/suno/v2/stems \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"music_id": "曲目 ID"
}
'import requests
url = "https://api.ephone.ai/suno/v2/stems"
payload = { "music_id": "曲目 ID" }
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({music_id: '曲目 ID'})
};
fetch('https://api.ephone.ai/suno/v2/stems', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ephone.ai/suno/v2/stems"
payload := strings.NewReader("{\n \"music_id\": \"曲目 ID\"\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))
}{
"code": "success",
"message": "success",
"data": {
"task_id": "5adac6ee-..."
}
}{
"code": "error",
"message": "music_id is required"
}{
"error": {
"message": "Invalid Token",
"type": "rix_api_error"
}
}{
"error": {
"message": "Too many requests, please try again later",
"type": "rix_api_error"
}
}拆分与重组
人声分离
从成曲里分离出主人声,或指定某一条乐器轨。
POST
/
suno
/
v2
/
stems
人声分离
curl --request POST \
--url https://api.ephone.ai/suno/v2/stems \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"music_id": "曲目 ID"
}
'import requests
url = "https://api.ephone.ai/suno/v2/stems"
payload = { "music_id": "曲目 ID" }
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({music_id: '曲目 ID'})
};
fetch('https://api.ephone.ai/suno/v2/stems', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ephone.ai/suno/v2/stems"
payload := strings.NewReader("{\n \"music_id\": \"曲目 ID\"\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))
}{
"code": "success",
"message": "success",
"data": {
"task_id": "5adac6ee-..."
}
}{
"code": "error",
"message": "music_id is required"
}{
"error": {
"message": "Invalid Token",
"type": "rix_api_error"
}
}{
"error": {
"message": "Too many requests, please try again later",
"type": "rix_api_error"
}
}也可以用统一任务接口
POST /v1/task/submit 提交:model 填 suno/stems,参数放进 input。两种写法效果与计费完全一样。任务结果
任务成功后,查询结果里产物的格式
任务结果
任务成功后,查询结果里产物的格式
任务成功后,
data.musics 里是产出的音轨。{
"code": "success",
"data": {
"task_id": "5adac6ee-...",
"action": "stems",
"model": "suno/stems",
"status": "SUCCESS",
"progress": "100%",
"submit_time": 1757800000000,
"finish_time": 1757800120000,
"musics": [
{
"music_id": "89b20862-...",
"title": "Rain on Tin Roof",
"tags": "lo-fi piano",
"audio_url": "https://...",
"image_url": "https://...",
"duration": 187.56
}
]
}
}
string
必填
曲目 ID。续写、翻唱、分轨、导出等后续操作都填它。
string
标题。
string
风格标签。
string
歌词,纯伴奏没有这个字段。
string
音频地址,可直接下载。
string
封面图地址。
string
大尺寸封面图地址。
string
视频地址,没有视频时不返回。
number
时长,单位秒。
授权
在请求头 Authorization: Bearer YOUR_API_KEY 里带上 API Key。
请求体
application/json
源曲目:要处理的曲目,填之前生成结果里的 music_id。
输出格式:成品音频的格式,不填默认 mp3。可选值:mp3 MP3(通用);m4a M4A;wav WAV(无损)。
可用选项:
mp3, m4a, wav 分轨类型:要单独分离出哪一条轨,不填默认取主人声。
可用选项:
lead_vocal, drum_kit, bass, backing_vocals, piano, electric_guitar, percussion, string_section, synth, acoustic_guitar, sound_effects, synth_pad, synth_bass, guitar, brass_section, organ, electronic_drum_kit, lead_electric_guitar, synth_keys, rhythm_electric_guitar, electric_piano, upright_bass, keyboards, distorted_electric_guitar, kick, snare, risers, synth_strings, synth_lead, woodwinds, flute, harp, tambourine, trumpet, arpeggiator, accordion, fiddle, pedal_steel_guitar, synth_voice, violin, digital_piano, synth_brass, mandolin, choir, banjo, bells, clarinet, tenor_saxophone, trombone, shaker, french_horn, glockenspiel, electric_bass, cello, timpani, harmonica, marimba, vibraphone, lap_steel_guitar, saxophone, orchestra, horns, cymbals, hand_clap, oboe, celesta, congas, drone, alto_saxophone, double_bass, ukulele, harpsichord, baritone_saxophone, xylophone, tuba, bass_guitar, whistle, lead_guitar, rhodes, 808, bongos, bassoon, cowbell, viola, sitar, steel_drums, piccolo, theremin, bagpipes, hi_hat, music_box, melodica, tabla, koto, djembe, taiko, didgeridoo 推送地址:任务结束后,把和查询结果相同的内容 POST 到这个地址(公网可以访问的 http / https 地址)。不传就自己查询。
此页面对您有帮助吗?