API de eliminación de voz

Actualizado el 2026-09-18 · equipo de Suno-API

Descripción del endpoint

La eliminación de voz divide una canción existente en dos pistas: voz y acompañamiento. Es la forma rápida de la separación: solo hay que enviar el ID de la canción de origen, no hay que elegir modo de separación, y el servidor siempre la procesa como dos pistas (two).

Endpoint: POST /api/music/vocal-removal

Facturación: Gratis. Este endpoint solo divide pistas; no genera coste de generación ni escribe registros de cobro.

Modelo recomendado: suno-v6. Se pueden usar suno-v6, suno-v6-wild y suno-v6-mini.

Autenticación

Parámetro	Tipo	Obligatorio	Notas
Authorization	string	sí	`Bearer YOUR_API_KEY`
Content-Type	string	sí	`application/json`

Parámetros de la petición

Parámetro	Tipo	Obligatorio	Por defecto	Notas
model	string	sí	-	Nombre de modelo para el cliente: `suno-v6`, `suno-v6-wild` o `suno-v6-mini`
source_clip_id	string	sí	-	El `song_id` real de la canción de origen; debe estar completada y ser accesible con la clave de API actual
source_audio_url	string	no	-	Dirección del audio de origen (cuando el origen pertenece a otra cuenta el servidor hace el relé; el cliente no necesita enviarla)
source_file_name	string	no	-	Nombre del archivo de origen; solo se usa para registros y visualización
song_title	string	no	-	Prefijo del título del resultado; por defecto se mantiene el título de la canción de origen

Alias compatibles: sourceClipId, audio_id, audioId y song_id pueden usarse en lugar de source_clip_id.

Ejemplo de petición

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "Eliminación de voz"
  }'

Respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Eliminación de voz (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Eliminación de voz (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Un solo envío devuelve 2 versiones × {Vocals, Instrumental}, por lo que clips suele contener 4 entradas. Agrupa por stem_from_id y distingue voz y acompañamiento por el sufijo de song_title.

Notas

Sondea las pistas resultantes con la API de consulta de canciones (POST /api/music/query) hasta completed antes de usarlas; GET /api/music/songs/:song_id y la lista de historial actualmente no incluyen las pistas producidas por la eliminación de voz — es una diferencia conocida.
Si necesitas elegir modo de dos o varias pistas, o dividir por nombre de pista, usa la API de separación (voz y acompañamiento).
Las pistas que no necesites se pueden ocultar con la API de eliminación de pista; no envíes solicitudes de eliminación repetidas.

SiguienteAPI de eliminación de stems

Obtener una clave de API

Crea una clave de API en la consola después de registrarte. Cada generación cuesta 0,6 ¥ y devuelve 2 pistas, las descargas son ilimitadas y no hace falta número de teléfono.

Obtener clave de API Volver al resumen