# API Box

## Docs

- [File Upload API Quickstart](https://docs.api.box/file-upload-api/quickstart.md): Get started with the File Upload API in minutes, supporting multiple upload methods
- [Base64 File Upload](https://docs.api.box/file-upload-api/upload-file-base-64.md): Upload temporary files via Base64 encoded data. Note: Uploaded files are temporary and automatically deleted after 3 days.
- [File Stream Upload](https://docs.api.box/file-upload-api/upload-file-stream.md)
- [URL File Upload](https://docs.api.box/file-upload-api/upload-file-url.md)
- [API.box Documentation](https://docs.api.box/index.md): Complete API.box documentation - Your gateway to affordable and stable AI music API services
- [Add Instrumental](https://docs.api.box/suno-api/add-instrumental.md): This endpoint generates a musical accompaniment tailored to an uploaded audio file — typically a vocal stem or melody track. It helps users instantly flesh out their vocal ideas with high-quality backing music, all without needing a producer.
- [Add Instrumental Callbacks](https://docs.api.box/suno-api/add-instrumental-callbacks.md): When instrumental generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Add Vocals](https://docs.api.box/suno-api/add-vocals.md): This endpoint layers AI-generated vocals on top of an existing instrumental. Given a prompt (e.g., lyrical concept or musical mood) and optional audio, it produces vocal output harmonized with the provided track.
- [Add Vocals Callbacks](https://docs.api.box/suno-api/add-vocals-callbacks.md): When vocal generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Boost Music Style](https://docs.api.box/suno-api/boost-music-style.md)
- [Convert to WAV Format](https://docs.api.box/suno-api/convert-to-wav-format.md): Convert existing music tracks to high-quality WAV format.
- [WAV Format Conversion Callbacks](https://docs.api.box/suno-api/convert-to-wav-format-callbacks.md): When WAV format conversion tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Music Cover](https://docs.api.box/suno-api/cover-suno.md): Create personalized cover images for generated music.
- [Music Cover Generation Callbacks](https://docs.api.box/suno-api/cover-suno-callbacks.md): When music cover generation is complete, the system will call this callback to notify results.
- [Create Music Video](https://docs.api.box/suno-api/create-music-video.md): Generate an MP4 video with visualizations for a music track.
- [Music Video Generation Callbacks](https://docs.api.box/suno-api/create-music-video-callbacks.md): When music video generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Extend Music](https://docs.api.box/suno-api/extend-music.md): Extend or modify existing music tracks.
- [Music Extension Callbacks](https://docs.api.box/suno-api/extend-music-callbacks.md): When music extension tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Lyrics](https://docs.api.box/suno-api/generate-lyrics.md): Create lyrics for music using AI models without generating audio tracks.
- [Lyrics Generation Callbacks](https://docs.api.box/suno-api/generate-lyrics-callbacks.md): When lyrics generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Mashup](https://docs.api.box/suno-api/generate-mashup.md): Mix two audio files to generate a new mashup work using AI models.
- [Generate MIDI from Audio](https://docs.api.box/suno-api/generate-midi.md): Convert separated audio tracks into MIDI format with detailed note information for each instrument.
- [MIDI Generation Callbacks](https://docs.api.box/suno-api/generate-midi-callbacks.md): System will call this callback when MIDI generation from separated audio is complete.
- [Generate Music](https://docs.api.box/suno-api/generate-music.md): Generate music with or without lyrics using AI models.
- [Music Generation Callbacks](https://docs.api.box/suno-api/generate-music-callbacks.md): When music generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Persona](https://docs.api.box/suno-api/generate-persona.md): Create a personalized music Persona based on generated music, giving the music a unique identity and characteristics.
- [Generate Sounds](https://docs.api.box/suno-api/generate-sounds.md): Create a sound generation task with loop, tempo, key, and optional lyrics subtitle capture settings.
- [Get Music Cover Details](https://docs.api.box/suno-api/get-cover-suno-details.md): Get detailed information about music cover generation tasks.
- [Get Lyrics Generation Details](https://docs.api.box/suno-api/get-lyrics-generation-details.md): Retrieve detailed information about a lyrics generation task, including status, parameters, and results.
- [Get MIDI Generation Details](https://docs.api.box/suno-api/get-midi-details.md): Retrieve detailed information about a MIDI generation task including complete note data for all detected instruments.
- [Get Music Generation Details](https://docs.api.box/suno-api/get-music-generation-details.md): Retrieve detailed information about a music generation task, including status, parameters, and results.
- [Get Music Video Details](https://docs.api.box/suno-api/get-music-video-details.md): Retrieve detailed information about a music video generation task, including status and download link.
- [Get Remaining Credits](https://docs.api.box/suno-api/get-remaining-credits.md): Retrieve the current balance of available credits for your account.
- [Get Timestamped Lyrics](https://docs.api.box/suno-api/get-timestamped-lyrics.md): Retrieve timestamped lyrics for synchronized display during audio playback.
- [Get Audio Separation Details](https://docs.api.box/suno-api/get-vocal-separation-details.md): Retrieve detailed information about vocal and instrument separation tasks, including status and download links.
- [Get WAV Conversion Details](https://docs.api.box/suno-api/get-wav-conversion-details.md): Retrieve detailed information about a WAV format conversion task, including status and download link.
- [Quick Start](https://docs.api.box/suno-api/quickstart.md): Get started with Suno API to generate AI music, lyrics, and audio content in minutes
- [Replace Music Section](https://docs.api.box/suno-api/replace-section.md): Replace a specific time segment within existing music.
- [Replace Music Section Callbacks](https://docs.api.box/suno-api/replace-section-callbacks.md): Understand the callback mechanism for replace music section tasks
- [Vocal and Instrument Separation](https://docs.api.box/suno-api/separate-vocals-from-music.md): Use advanced audio processing technology to separate music into vocal, instrumental, and individual instrument tracks.
- [Audio Separation Callbacks](https://docs.api.box/suno-api/separate-vocals-from-music-callbacks.md): When vocal and instrument separation generation is complete, the system will call this callback to notify the results.
- [Upload And Cover Audio](https://docs.api.box/suno-api/upload-and-cover-audio.md): This API covers an audio track by transforming it into a new style while retaining its core melody. It incorporates Suno's upload capability, enabling users to upload an audio file for processing. The expected result is a refreshed audio track with a new style, keeping the original melody intact.
- [Upload and Cover Audio Callbacks](https://docs.api.box/suno-api/upload-and-cover-audio-callbacks.md): When upload and cover audio tasks are completed, the system will send results to your provided callback URL via POST request
- [Upload And Extend Audio](https://docs.api.box/suno-api/upload-and-extend-audio.md): This API extends audio tracks while preserving the original style of the audio track. It includes Suno's upload functionality, allowing users to upload audio files for processing. The expected result is a longer track that seamlessly continues the input style.
- [Upload and Extend Audio Callbacks](https://docs.api.box/suno-api/upload-and-extend-audio-callbacks.md): When upload and extend audio tasks are completed, the system will send results to your provided callback URL via POST request

## OpenAPI Specs

- [file-upload-api](https://docs.api.box/file-upload-api/file-upload-api.json)
- [file-upload-api-cn](https://docs.api.box/cn/file-upload-api/file-upload-api-cn.json)
- [suno-api](https://docs.api.box/suno-api/suno-api.json)
- [suno-api-cn](https://docs.api.box/cn/suno-api/suno-api-cn.json)

## Optional

- [Home](https://api.box/)