上传并分离人声

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "upload-and-separate-vocals",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "title": "我的音轨",
    "audio_url": "https://cdn.vidgo.ai/temp/audio/my-track.mp3",
    "model_name": "base",
    "output_type": "general"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 409,
  "error": {
    "message": "Separation already exists for this audio",
    "type": "conflict_error"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "upload-and-separate-vocals",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "title": "我的音轨",
    "audio_url": "https://cdn.vidgo.ai/temp/audio/my-track.mp3",
    "model_name": "base",
    "output_type": "general"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 409,
  "error": {
    "message": "Separation already exists for this audio",
    "type": "conflict_error"
  }
}

提交后会返回 task_id。如果提供了 callback_url，当任务状态变为 finished 或 failed 时，系统会向 callback_url 发送 POST 请求。
无论是否提供 callback_url，都可以通过统一的查询音乐详情接口获取结果。

使用指南

人声分离方式：

separate-vocals：不支持上传音频，2 轨分离，基于 Suno
stem-split：不支持上传音频，12 轨分离，基于 Suno
upload-and-separate-vocals：支持上传音频，7 轨分离

此接口上传音频并将其拆分为多条分轨
为贝斯、鼓、钢琴、吉他、人声和其他乐器分别生成独立音轨
适用于混音或从上传的音频中单独提取特定乐器

参数详情

audio_url（必填）：要上传并分离的音频文件 URL
title（可选）：分离任务的标题
model_name（可选）：使用的分离模型。默认：base
- base：标准分离质量
- enhanced：更高质量、更准确的分离
- instrumental：针对纯音乐曲目优化
output_type（可选）：要生成的输出分轨类型。默认：general
- general：所有可用分轨
- bass：仅贝斯音轨
- drums：仅鼓音轨
- other：其他乐器
- piano：仅钢琴音轨
- guitar：仅吉他音轨
- vocals：仅人声音轨

授权

Authorization

string

header

必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key：

进入仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key

在请求头中添加：

Authorization: Bearer VIDGO_API_KEY

请求体

application/json

model

string

必填

示例:

"upload-and-separate-vocals"

callback_url

string<uri>

必填

用于结果通知的 Webhook 回调 URL。

该地址会收到 POST 请求，包含分离完成状态和各音轨的下载 URL。

示例:

"https://your-domain.com/callback"

input

object

必填

上传并分离人声的输入参数

Show child attributes

响应

任务提交成功

code

integer

必填

HTTP 状态码

示例:

200

data