上传 Voice 样本
curl --request POST \
--url https://apistable.ai/api/v1/tasks/create_task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "suno_voice_upload",
"input": {
"voice_url": "https://example.com/voice.wav",
"vocal_start_s": 0,
"vocal_end_s": 20
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'suno_voice_upload',
input: {voice_url: 'https://example.com/voice.wav', vocal_start_s: 0, vocal_end_s: 20}
})
};
fetch('https://apistable.ai/api/v1/tasks/create_task', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apistable.ai/api/v1/tasks/create_task"
payload = {
"model": "suno_voice_upload",
"input": {
"voice_url": "https://example.com/voice.wav",
"vocal_start_s": 0,
"vocal_end_s": 20
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"code": 200,
"msg": "success",
"data": {
"task_id": "<string>"
}
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}Suno
上传 Voice 样本
先上传音色样本并选择片段,再获取验证短句、朗读验证,最后检查 Voice 可用性。
POST
/
api
/
v1
/
tasks
/
create_task
上传 Voice 样本
curl --request POST \
--url https://apistable.ai/api/v1/tasks/create_task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "suno_voice_upload",
"input": {
"voice_url": "https://example.com/voice.wav",
"vocal_start_s": 0,
"vocal_end_s": 20
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'suno_voice_upload',
input: {voice_url: 'https://example.com/voice.wav', vocal_start_s: 0, vocal_end_s: 20}
})
};
fetch('https://apistable.ai/api/v1/tasks/create_task', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apistable.ai/api/v1/tasks/create_task"
payload = {
"model": "suno_voice_upload",
"input": {
"voice_url": "https://example.com/voice.wav",
"vocal_start_s": 0,
"vocal_end_s": 20
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"code": 200,
"msg": "success",
"data": {
"task_id": "<string>"
}
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}{
"code": 123,
"msg": "<string>",
"data": null
}能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务;音乐积分扣除当前未启用。
调用步骤
先上传音色样本并选择片段,再获取验证短句、朗读验证,最后检查 Voice 可用性。-
- 按下方示例准备输入,将占位地址和 ID 换成你有权使用的资源。
-
- 将 model 设为 suno_voice_upload,参数放在 input 内。提交一次并保存返回的 task_id。
-
- 查询已保存的任务,或接收回调。任务仍在处理中时继续等待,不重新提交同一操作。
- result.ready 为 true 后,将 result.voice_upload_task_id 传给验证短句接口。
创建任务
将model和input发送到统一任务入口;可在顶层传公开HTTPS callback_url。资源ID均为本账户的本站ID。当前音乐积分扣除未启用。{
"model": "suno_voice_upload",
"input": {
"voice_url": "https://example.com/voice.wav",
"vocal_start_s": 0,
"vocal_end_s": 20
}
}
受理响应
HTTP 200仅表示受理。查询GET /api/v1/tasks/{task_id},直到data.status为succeeded或failed。成功后读取data.result;失败原因位于data.message。{
"code": 200,
"msg": "success",
"data": {
"task_id": "YOUR_TASK_ID"
}
}
参数速查
| 字段 | 类型 | 必填 | 说明与限制 |
|---|---|---|---|
| voice_url | string | 是 | 原始声音录音的公开HTTPS URL:MP3/WAV/FLAC/OGG/M4A/AAC,最多500 MiB,时长大于零。 |
| vocal_start_s | number | 是 | 选中人声开始位置(秒),最多两位小数。Voice上传使用原始录音时间轴,歌曲Persona使用预处理人声时间轴。 min: 0 |
| vocal_end_s | number | 是 | 选中人声结束位置(秒),最多两位小数;须大于开始位置且不超出音频时长。歌曲声音Persona需选择10–30秒。 min: 0 |
| name | string | 否 / 依条件 | Voice 或 Persona 展示名称。 maxLength: 100 |
| description | string | 否 / 依条件 | Voice 或 Persona 描述。 maxLength: 1000 |
输入与限制
下方Schema列出支持字段、类型和基础限制;还须遵守“重要条件”,跨字段与来源资源校验不完全体现在JSON Schema中。未知参数会被拒绝。URL 参数仅接受公开 HTTPS 地址,不接受文件对象。{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"voice_url": {
"type": "string",
"format": "uri",
"description": "原始声音录音的公开HTTPS URL:MP3/WAV/FLAC/OGG/M4A/AAC,最多500 MiB,时长大于零。"
},
"vocal_start_s": {
"type": "number",
"minimum": 0,
"description": "选中人声开始位置(秒),最多两位小数。Voice上传使用原始录音时间轴,歌曲Persona使用预处理人声时间轴。"
},
"vocal_end_s": {
"type": "number",
"minimum": 0,
"description": "选中人声结束位置(秒),最多两位小数;须大于开始位置且不超出音频时长。歌曲声音Persona需选择10–30秒。"
},
"name": {
"type": "string",
"maxLength": 100,
"description": "Voice 或 Persona 展示名称。"
},
"description": {
"type": "string",
"maxLength": 1000,
"description": "Voice 或 Persona 描述。"
}
},
"required": [
"voice_url",
"vocal_start_s",
"vocal_end_s"
],
"additionalProperties": false
}
重要条件
- 选段须满足0 ≤ vocal_start_s < vocal_end_s ≤录音实际时长,最多两位小数。等待ready:true后再取得短句;成功准备的样本会话有效24小时。
- 此步骤的name/description不会自动复制到最终Voice;需要时请在suno_voice_create中重新填写。
- 音频URL必须包含可读且时长大于零的MP3/WAV/FLAC/OGG/M4A/AAC音轨,每个文件最多500 MiB。URL须为可公开读取的HTTPS地址、端口443,不含用户名密码或私网地址,且应持续可访问直到任务结束。
- 上传文件保留24小时,生成文件保留14天,任务详情保留30天;复用文件沿用原到期时间。有效Voice/Persona身份映射与任务日志清理分开处理,请及时下载需长期保存的文件。
结果 Schema
创建响应为 {code:200,msg:“success”,data:{task_id}},轮询 GET /api/v1/tasks/{task_id}。成功时 data.result 为符合下方 Schema 的对象,其他状态为 null;input 仍为 JSON 字符串。{
"type": "object",
"required": [
"voice_upload_task_id",
"ready"
],
"properties": {
"voice_upload_task_id": {
"type": "string"
},
"ready": {
"const": true
}
},
"additionalProperties": false
}
相关流程
Voice 完整四步 文件上传 回调授权
Every valid key can submit and query its own account. Revoked keys are rejected.
请求体
application/json