API de generación/obtención de WAV

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

Descripción del endpoint

El endpoint WAV genera u obtiene la dirección de audio WAV sin pérdida de una canción existente.

Endpoint: POST /api/music/wav

Facturación: Gratis. Este endpoint genera u obtiene la dirección WAV de una canción existente y no descuenta cuota.

Tiempos de espera y timeouts (importante): es un endpoint síncrono — el pedido solo se acepta cuando llega la respuesta. Según lo medido, la mayoría de las peticiones responden en 1-3 segundos, alrededor del 10% tardan más de 30 segundos y la más lenta ronda los 230 segundos. Configura el timeout del cliente en 300 segundos o más; no recibir respuesta no significa que no se haya generado nada, y no reintentes justo después de un timeout. Si la conexión se cayó, confírmalo más tarde con GET /api/music/songs. Consulta «Tiempos de espera y configuración de timeout» en el Resumen de la nueva API.

Parámetros de la petición

Headers

Parámetros del cuerpo

maxAttempts e intervalSeconds son ambos números JSON; intervalSeconds se mide en segundos, no en milisegundos, y normalmente basta con dejar los valores por defecto. Solo controlan cuántas veces y con qué intervalo espera internamente este endpoint a que el WAV esté listo; no cambian el estado de la tarea de generación en sí.

Ejemplo de petición

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

Respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

Notas

La generación y la consulta del WAV las selecciona el servidor automáticamente a partir del registro de la canción; el cliente no necesita aportar ningún dato de cuenta.

Las canciones normales y las pistas separadas usan la misma ruta controlada de entrega de medios. El WAV lo descarga y guarda primero CN2, y el data.wavUrl de una respuesta correcta solo devuelve una dirección de CDN controlada, nunca una dirección temporal de origen de Suno o S3.

Cuando ya existe un activo WAV en estado ready se reutiliza, sin volver a pedirlo a Suno ni mover archivos. Un WAV aún no preparado no se expone como dirección de Suno/S3 a través de /api/music/query; se prepara bajo demanda solo después de llamar a este endpoint o al endpoint unificado de descarga.

⚠️ Validez de la dirección WAV: 7 días, guárdala a tiempo. El data.wavUrl devuelto lo sirve el almacenamiento de objetos de la plataforma y caduca por defecto a los 7 días (el archivo se reclama y la dirección antigua devuelve 404). Guarda el WAV en tu propio almacenamiento dentro de ese plazo; cuando caduque, vuelve a llamar a este endpoint para obtener una dirección válida nueva.

Si el recurso de la canción no está disponible temporalmente, el endpoint devuelve 409. Reinténtalo más tarde; el servidor no devuelve direcciones temporales inestables.