---
title: "Get audio upload URL"
method: POST
path: "/uploads/audio/get_upload_url"
tags: ["Uploads"]
---

# Get audio upload URL

`POST /uploads/audio/get_upload_url`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/uploads/audio/get_upload_url`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get a pre-signed URL for audio upload. Use this to upload audio for node parameters (e.g., background music). Max 500MB, 5 hour duration. After uploading, call `/uploads/audio/finalize_upload` to get the audio UUID.

## Response `200`

Upload URL generated successfully

- AudioUploadUrlResponse
  - `audio_id` string: UUID for the audio. Use this to call finalize_upload and in update_params.
  - `upload_url` string: URL to POST the file to
  - `upload_fields` object: Form fields to include before the file in the POST request
  - `max_file_size_bytes` integer: Maximum file size (100MB)

## Other responses

- `401`: Authentication failed

---

[API](https://skmtc.dev/mosaic/apis/mosaic-ai-api.md) - [All operations](https://skmtc.dev/mosaic/apis/mosaic-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mosaic/apis/mosaic-ai-api/revisions/c20e9fc606a4?raw)