neuralanalog

Neural Analog API endpoint

Poll Processing Status

Check whether an imported, restored, mastered, stem split, or stem artifact is still processing, completed, or failed.

get/status/{object_type}/{object_id}
Get a key
Poll Processing Status

Check whether a Neural Analog job or artifact is ready.

Use this after any endpoint that returns an ID for background work. Importing, restoration, mastering, and stem separation all return before the heavy processing has finished. Poll this endpoint with the returned ID until is_complete is true or is_failed is true.

Typical polling sequence:

text
POST /from-link -> audio_id
GET /status/audio/{audio_id}

POST /upscale-audio -> id
GET /status/upscaled/{id}

POST /master-audio -> id
GET /status/mastered/{id}

POST /create-stems -> creation_id
GET /status/stem_split/{creation_id}

POST /run-workflow -> workflow_run_id
GET /status/workflow/{workflow_run_id}

When a downloadable artifact is complete, the response includes a download_url. You can also call GET /download/{object_type}/{object_id} directly with the same object type and ID.

Parameters

object_type
requiredpathstring
Object type to inspect: audio, upscaled, mastered, stem_split, stem, or workflow.
object_id
requiredpathstring
ID returned by a queueing endpoint.
x-api-key
optionalheaderstring | null
No description provided.

Example

Python
import os
import requests
response = requests.get(
    "https://api.neuralanalog.com/status/audio/00000000-0000-0000-0000-000000000000",
    headers={"X-API-Key": os.environ["NEURALANALOG_API_KEY"]},
)
print(response.json())

Success Response

200Successful Response
object_type
requiredstring

Kind of object that was checked.

Example: "upscaled"

object_id
requiredstring

ID of the checked job or artifact.

Example: "d66cf940-bf26-45bb-80f7-332f26b6859a"

status
requiredstring

Current processing state.

Example: "completed"

is_complete
requiredboolean

True when the artifact is ready to download or use.

Example: true

is_failed
requiredboolean

True when the job cannot complete and error_message is set.

Example: false

download_url
optionalstring | null

Download endpoint URL for completed downloadable artifacts.

Example: "https://api.neuralanalog.com/download/upscaled/d66cf940-bf26-45bb-80f7-332f26b6859a"

audio_id
optionalstring | null

Parent audio asset ID when the checked object belongs to a track.

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

status_details
optionalstring | null

Additional human-readable progress details when available.

Example: "Restoration completed"

error_message
optionalstring | null

Failure reason when is_failed is true.

Example: "Source audio is no longer available"

created_at
optionalstring | null

ISO timestamp for when the job or artifact was created.

Example: "2026-05-05T10:15:30Z"

completed_at
optionalstring | null

ISO timestamp for when processing completed.

Example: "2026-05-05T10:18:42Z"