Audio Processing & StemstaskType: convert_to_wav10 Credits / TaskAsync Webhook & Polling

Convert Audio to WAV Format

Decompress standard compressed MP3/AAC audio files into studio-quality, uncompressed Linear PCM WAV format. Delivers pristine audio fidelity with zero psychoacoustic compression artifacts, ready for professional DAW mixing, mastering, and high-resolution archival.

POST/api/v1/createTask
Test in Playground

Why Convert to Lossless WAV?

Studio Standard
MP3 (Original)COMPRESSED

Lossy encoding designed for rapid web streaming and compact file size. High frequencies above 16kHz–18kHz and subtle dynamic nuances are filtered out.

WAV PCM (Converted)LOSSLESS PCM

Uncompressed 16-bit / 44.1kHz Linear PCM broadcast format. Full dynamic range headroom, transparent frequency spectrum, and native DAW compatibility.

Key Capabilities & DAW Workflows

  • Professional DAW Import: Drag and drop rendered songs directly into Pro Tools, Ableton Live, Logic Pro, Cubase, or FL Studio without generation clipping or encoding artifacts.
  • Mastering Headroom: Provides pure digital PCM audio data allowing EQ, multiband compression, and limiter plug-ins to operate with maximum mathematical precision.
  • 14-Day Cloud Retention: Converted lossless WAV files are hosted on high-bandwidth edge CDN servers for 14 days. Make sure to download assets for long-term production archives.
  • Low Credit Cost: Only consumes 10 credits per conversion. If an invalid audio track is submitted or the upstream transcode encounters an error, credits are immediately refunded.

Validation Rules & Constraints

Target Task & Audio IDs

Both task_id and audio_id must match an existing music generation task that has already finished rendering audio.

Asynchronous Webhook Notification

Since lossless rendering takes several seconds to re-sample and render, provide a valid callBackUrl to be notified as soon as the WAV download link is ready.

Authentication & Headers

HeaderRequirementDescription
Authorizationrequired

Bearer YOUR_API_KEY

Secret API key generated in your dashboard.

Content-Typerequired

application/json

Request body format.

Request Body Parameters

4 fields
task_idstringrequired

Unique identifier of the original music generation task containing the target song.

audio_idstringrequired

Unique identifier (UUID) of the specific audio track within the generation task to convert to lossless WAV format.

taskTypestringoptional
default:convert_to_wav

Explicit task routing identifier. Can be set to "convert_to_wav".

callBackUrlstringoptional

Public HTTPS webhook URL to receive asynchronous completion notification containing the lossless WAV download URL.

When Callbacks Are Sent

The SongMesh API automatically triggers an HTTP POST request to your designated callBackUrl under these events:

  • Conversion task submitted and placed in the lossless transcode queue
  • Full-resolution PCM audio decompression and waveform rendering initiated
  • Lossless WAV file rendered and uploaded to global edge CDN storage
  • Task completed successfully or failed due to invalid audio ID (code: 200 or 400/500)

Webhook Payload Format

Response Body(200 status)
{
  "code": 200,
  "msg": "All generated successfully.",
  "data": {
    "task_id": "988e0b6a2c7d4e5f8a1b2c3d4e5f6a7b",
    "audio_wav_url": "https://file.aiquickdraw.com/s/04e6789a-bcde-f012-3456-789abcdef012.wav"
  }
}

Callback Payload Fields

FieldTypeDescription
codeintegerHTTP status code (200: Success, 400: Bad Request, 500: Server error).
msgstringExecution status message ("All generated successfully." or error details).
data.task_idstringUnique task identifier corresponding to the WAV conversion task.
data.audio_wav_urlstringDirect signed CDN download URL for the uncompressed, lossless broadcast WAV file.

Receiver Implementation Example

Webhook Receiver
// Next.js App Router Webhook Receiver (/api/webhook/suno/route.ts)
import { NextRequest, NextResponse } from 'next/server';

export async function POST(req: NextRequest) {
  const payload = await req.json();
  const { code, msg, data } = payload;

  if (code === 200 && (data?.audio_wav_url || data?.audioWavUrl)) {
    const wavUrl = data.audio_wav_url || data.audioWavUrl;
    console.log(`WAV conversion completed for task ${data.task_id}!`);
    console.log(`Lossless WAV URL: ${wavUrl}`);

    // Download WAV file, save to S3/GCS bucket, or trigger DAW post-processing
  } else {
    console.error(`WAV conversion failed (${code}): ${msg}`);
  }

  return NextResponse.json({ received: true });
}

Webhook Security Recommendation

Always verify incoming webhook payloads on your server. Respond with a 200 OK immediately after parsing the payload to prevent redundant delivery retries from the webhook dispatcher.

Request Sample
curl -X POST "https://api.sunoapi.top/api/v1/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "convert_to_wav",
    "task_id": "3e63b4cc88d52611159371f6af5571e7",
    "audio_id": "8ca376e7-5b62-49d9-bbd3-08aaf2c6dd27",
    "callBackUrl": "https://api.yourdomain.com/webhook/suno"
  }'
Response Body(200 status)
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_wav_1740000000000_abc123"
  }
}
WAV Conversion Pro Tips

• Audio Quality: Converting to WAV eliminates MP3 compression artifacts for all subsequent processing, mastering, or vinyl cut pressing.

• DAW Workflow: Combine this with Stem Separation for professional multitrack studio workflows.

• Pricing: Costs 10 credits per converted song file.

Previous EndpointStem Separation (Vocals & Instruments)Next EndpointRecovery Audio Records

Ready to convert audio tracks to lossless WAV?

Generate your API secret key and export studio-quality uncompressed WAV PCM audio in seconds.

Generate Secret Key