API de remasterización (Remaster)

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

Descripción del endpoint

La remasterización regenera una canción ya terminada como una "versión remasterizada" con mejor calidad de audio. Devuelve 2 versiones a la vez y el upstream añade automáticamente (Remastered) al título.

Endpoint: POST /api/music/remaster

Facturación: De pago, facturada según el modelo solicitado (por defecto suno-v6, 0,6 CNY por llamada); el importe realmente cobrado sigue la configuración de precios del back-office.

Sobre el modelo: la remasterización usa un endpoint upstream dedicado y un modelo de remasterización dedicado, fijados por la plataforma y que no cambian con model; el model de la petición solo se usa para el precio y la selección de canal, y se recomienda pasar suno-v6 explícitamente.

Tiempos de espera y timeouts (importante): es un endpoint síncrono — el pedido solo se acepta y se entrega a la remasterización cuando llega la respuesta. Configura el timeout del cliente en 300 segundos o más; no recibir respuesta no significa que no se haya remasterizado nada, y no reintentes justo después de un timeout (eso duplica el pedido y vuelve a cobrar). Si la conexión se cayó, confírmalo más tarde con GET /api/music/songs.

Autenticación

Parámetros de la petición

audio_id, source_clip_id y sourceClipId son formas equivalentes de song_id; usa cualquiera de ellas.

Ejemplo de petición

curl -X POST https://www.suno-api.io/api/music/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

Si te bastan los valores por defecto, envía solo la canción de origen: equivale a variation_category: normal + style_profile: boost:

{ "model": "suno-v6", "song_id": "source_song_id" }

Respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Título de la canción original (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Título de la canción original (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Una llamada devuelve 2 versiones remasterizadas. Guarda los dos clips[].song_id y sondea la API de consulta de canciones hasta complete antes de descargar el audio.

Notas

• La canción de origen debe estar terminada y dentro del ámbito de acceso de la clave de API actual; el material de origen externo se sincroniza automáticamente con la cuenta que ejecuta.
• La remasterización solo rehace la calidad de audio: para cambiar el estilo, los arreglos o la voz, usa potenciar estilo, subir y hacer cover o los endpoints de Remix.
• Cuanto mayor sea variation_category, más difiere la versión remasterizada de la canción de origen; antes de una entrega real, prueba con normal y luego sube.