Skip to main content
GET
This endpoint does not return the usual JSON envelope on success. Success is an audio/mpeg byte stream. A rejected request, by contrast, is answered with the standard JSON error envelope. Check Content-Type (or the JSON code) before writing the file, so an error message is never saved as an .mp3.
string
required
API key for authentication.

Path

string
required
The project identifier. The song must be READY with a usable readyAsset.

Response

string
audio/mpeg on success; a JSON content type when the request is rejected.
string
attachment; filename="MyVocal-<name>.mp3".
stream
MP3 audio bytes.

Common errors

  • code = 47009: the project does not exist or is not owned by your account.
  • code = 47015: the song is not ready to download yet, or storage is temporarily unavailable — poll the project and retry.