API de eliminación de stems

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

Descripción del endpoint

La eliminación de stems oculta de la lista las pistas de stem ya generadas. El borrado es una eliminación lógica: el backend solo marca las filas de stem con stem_hidden; el audio, el MIDI y los recursos de descarga subyacentes se conservan, y la misma canción puede volver a separarse en stems nuevos más adelante.

Endpoint: POST /api/music/stem-delete

Facturación: Gratis. El borrado solo actualiza la visibilidad dentro de la plataforma; no llama a Suno ni genera ningún cargo.

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
song_id	string	no	-	`song_id` de una sola pista de stem (el ID de pista que devuelve `/api/music/separate`)
song_ids	string[]	no	-	Forma por lotes, como máximo 100 por llamada
stem_batch_id	string	no	-	Borrar por lote: elimina todas las pistas de ese lote de separación automática
stem_mode	string	no	-	Borrar por modo, por ejemplo `two`, `twelve`

Debe enviarse al menos uno de song_id / song_ids / stem_batch_id / stem_mode; si no, la respuesta es 400.

Ejemplo de petición

curl -X POST https://www.suno-api.io/api/music/stem-delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["stem_track_id_1", "stem_track_id_2"]
  }'

Respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "hidden": 2,
    "affected_sources": 1
  }
}

Campo	Tipo	Notas
hidden	number	Número de pistas ocultadas por esta llamada
affected_sources	number	Número de canciones de origen afectadas

Notas

Idempotente: si la pista ya está oculta o el ID no existe, la respuesta es hidden: 0 sin error, así que repetir la llamada es seguro.
El borrado solo afecta a canciones de la clave de API actual; las pistas que no son tuyas no se tocan.
Cuando se oculta el último stem visible de la lista, la marca de «separada» de la canción de origen se borra con él.

SiguienteAPI de generación/obtención de WAV

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