Download Object

Redirect to a signed download URL for an original track, stem, restored audio, or mastered audio artifact.

get/download/{object_type}/{object_id}

Get a key

Download Object

Download a completed audio artifact.

Use this only after status polling reports completion. The endpoint does not stream bytes itself; it returns a 307 redirect to a temporary signed storage URL.

Typical flow:

text

GET /status/upscaled/{id} -> is_complete: true
GET /download/upscaled/{id} -> 307 Location: signed file URL

Use object_type=audio for the original imported/uploaded file, stem for an individual stem, upscaled for restored audio, and mastered for mastered audio.

Parameters

object_type

requiredpathstring

Artifact collection to download. Common values are audio, stem, upscaled, and mastered.

object_id

requiredpathstring

Identifier for the requested artifact in the selected object_type.

format

optionalquerystring

Preferred output format when the artifact supports format selection.

track

optionalqueryboolean

Whether this request should count as a user download.

Example

Python

import os
import requests
response = requests.get(
    "https://api.neuralanalog.com/download/audio/00000000-0000-0000-0000-000000000000?format=wav&track=true",
    headers={"X-API-Key": os.environ["NEURALANALOG_API_KEY"]},
)
print(response.json())

Success Response

307Temporary redirect to the signed artifact download URL.

Headers

Location

Temporary signed URL for the downloadable file.