neuralanalog

Neural Analog API endpoint

Download Archive

Package requested track or stem versions for one or more audio IDs into one temporary zip archive.

post/download-archive
Get a key
Download Archive

Package completed tracks or stems into one temporary zip archive.

Use this after the requested versions are complete. For example, poll /status/audio/{audio_id}, /status/upscaled/{id}, /status/mastered/{id}, or /status/stem_split/{creation_id} before requesting the corresponding archive versions.

Track and stem archive versions are separate requests:

json
{"id": "audio-id", "versions": ["original", "mastered"], "format": "wav"}
json
{"id": "audio-id", "versions": ["original_stems"], "format": "wav"}

The response usually contains download_url. For large archives, the API may return email_notification_queued: true; in that case archive creation continues in the background and the signed link is delivered by email.

Parameters

x-api-key
optionalheaderstring | null
No description provided.

Request Body

versions
requiredarray<string>

Artifact versions to include. Use original/restored/mastered for full-track audio and original_stems/restored_stems/mastered_stems for stem archives.

Example: ["original","mastered"]

id
optionalstring | null

Single audio asset ID to package.

Example: "6c62f8e7-02a3-48c0-a5b5-5de87ed9c31a"

ids
optionalarray<string> | null

Audio asset IDs to package into one zip archive.

Example: ["6c62f8e7-02a3-48c0-a5b5-5de87ed9c31a","0d8ea9f2-ae8c-4af7-b73e-4b241ae5ce88"]

stem_ids
optionalarray<string> | null

Optional stem IDs to include when downloading stem versions.

Example: ["abf8a992-1c4e-4935-93f0-197116e77e49"]

stem_selections
optionalarray<object> | null

Exact per-stem versions to include when downloading stem archives.

Example: [{"mastered_id":"f5db8e4b-2e74-4198-a8de-0c3a398620e9","stem_id":"abf8a992-1c4e-4935-93f0-197116e77e49","version":"mastered"}]

format
optionalstring

Default requested archive format for stem versions.

"wav""flac""mp3""m4a"

Default: "wav"

original_format
optionalstring | null

No description provided.

"wav""flac""mp3""m4a"
restored_format
optionalstring | null

No description provided.

"wav""flac""mp3""m4a"
mastered_format
optionalstring | null

No description provided.

"wav""flac""mp3""m4a"

Example

Python
import os
import requests
response = requests.post(
    "https://api.neuralanalog.com/download-archive",
    headers={"X-API-Key": os.environ["NEURALANALOG_API_KEY"]},
    json={
        "id": "00000000-0000-0000-0000-000000000000",
        "versions": [
            "original",
            "mastered",
        ],
        "format": "wav",
    },
)
print(response.json())

Success Response

200Successful Response
download_url
optionalstring | null

Temporary URL for the generated zip archive. Null when archive creation continues in the background and the user will be emailed.

Example: "https://storage.example.com/neuralanalog/archive.zip"

expires_in_seconds
optionalinteger

How long the generated zip URL remains valid.

Default: 86400

email_notification_queued
optionalboolean

Whether the archive is still being created and a download email has been queued.

Default: false

email_notification_threshold_seconds
optionalinteger | null

Server-side zipping duration threshold that triggers email delivery.

Example: 30

archive_incomplete
optionalboolean

Whether some requested files were skipped because the archive hit size or processing limits.

Default: false