Upload Audio From File

Upload an encoded audio file directly via multipart form data to create an audio asset for processing.

post/from-file

Get a key

Upload an audio file directly via multipart form data.

Use this when you have an audio file to upload directly, without a URL. The API creates an audio_id immediately and finalizes the file in the background. Authenticate API clients with X-API-Key: $NEURALANALOG_API_KEY.

Multipart form body:

text

- audio: required encoded audio file.
- file_source: optional source label; defaults to "from_file".

After this endpoint returns:

text

1. Save `audio_id` from the response.
2. Poll `GET /status/audio/{audio_id}` until `is_complete` is true.
3. Use that `audio_id` with `/upscale-audio`, `/master-audio`,
   `/create-stems`, `/download-archive`, or `/download/audio/{audio_id}`.

Example usage:

python

import os
import requests

with open("./my-audio.mp3", "rb") as audio:
    response = requests.post(
        "https://api.neuralanalog.com/from-file",
        headers={"X-API-Key": os.environ["NEURALANALOG_API_KEY"]},
        files={"audio": audio},
        data={"file_source": "from_file"},
    )

if response.status_code == 200:
    audio_id = response.json()["audio_id"]

Parameters

x-api-key

optionalheaderstring | null

No description provided.

Example

Python

import os
import requests
response = requests.post(
    "https://api.neuralanalog.com/from-file",
    headers={"X-API-Key": os.environ["NEURALANALOG_API_KEY"]},
)
print(response.json())

Success Response

200Successful Response

audio_id

requiredstring

ID of the uploaded audio asset.

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

status

requiredstring

Status of the uploaded audio asset. Returns 'in_progress' while the file is being finalized in the background.

Example: "in_progress"

message

requiredstring

Human-readable status message for the upload request.

Example: "File uploaded successfully"