# API Box

- [API.box Documentation](https://docs.api.box/index.md): Complete API.box documentation - Your gateway to affordable and stable AI music API services
- [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

## Generate Music

- [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
- [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
- [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
- [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
- [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.
- [Recovery Audio](https://docs.api.box/suno-api/recovery-audio.md): Recover playable audio links for an existing music generation task.
- [Get Recovery Audio Details](https://docs.api.box/suno-api/get-recovery-audio-details.md): Query the status and recovered audio links of a recovery task.
- [Get Timestamped Lyrics](https://docs.api.box/suno-api/get-timestamped-lyrics.md): Retrieve timestamped lyrics for synchronized display during audio playback.
- [Boost Music Style](https://docs.api.box/suno-api/boost-music-style.md)
- [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.
- [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
- [Get Music Cover Details](https://docs.api.box/suno-api/get-cover-suno-details.md): Get detailed information about music cover generation tasks.
- [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 Mashup](https://docs.api.box/suno-api/generate-mashup.md): Mix two audio files to generate a new mashup work using AI models.

## Suno Voice

- [Suno Voice Generate Verification Phrase](https://docs.api.box/suno-api/suno-voice-validate.md): Generate the validation phrase required for the Suno Voice custom voice workflow.
- [Suno Voice Validation Phrase Callbacks](https://docs.api.box/suno-api/suno-voice-validate-callbacks.md): Receive POST callbacks when a Suno Voice validation phrase task is ready or fails.
- [Suno Voice Get Verification Phrase](https://docs.api.box/suno-api/suno-voice-validate-info.md): Query the validation phrase generation result for a Suno Voice task.
- [Suno Voice Create Custom Voice](https://docs.api.box/suno-api/suno-voice-generate.md): Generate a reusable Suno custom voice from the user's verification recording.
- [Suno Voice Generation Callbacks](https://docs.api.box/suno-api/suno-voice-generate-callbacks.md): Receive POST callbacks when a Suno Voice custom voice task succeeds or fails.
- [Suno Voice Get Custom Voice Record](https://docs.api.box/suno-api/suno-voice-record-info.md): Query the custom Suno Voice generation result and obtain the generated voiceId.
- [Suno Voice Regenerate Verification Phrase](https://docs.api.box/suno-api/suno-voice-regenerate.md): Regenerate the validation phrase for an existing Suno Voice task.
- [Suno Voice Regenerate Phrase Callbacks](https://docs.api.box/suno-api/suno-voice-regenerate-callbacks.md): Receive POST callbacks when a regenerated Suno Voice validation phrase is ready or fails.
- [Suno Voice Check Availability](https://docs.api.box/suno-api/suno-voice-check-voice.md): Check whether a generated Suno custom voice is available for use.

## Lyrics Generation

- [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
- [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.

## Generate Sounds

- [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.

## WAV Conversion

- [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
- [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.

## Vocal Removal

- [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.
- [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.
- [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.
- [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.

## Music Video Generation

- [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
- [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.

## Account Management

- [Get Remaining Credits](https://docs.api.box/suno-api/get-remaining-credits.md): Retrieve the current balance of available credits for your account.

## File Upload API

- [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)

## OpenAPI Specs

- [suno-api](/suno-api/suno-api.json)
- [suno-voice-api](/suno-api/suno-voice-api.json)
- [file-upload-api](/file-upload-api/file-upload-api.json)

## Optional

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

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [Chinese (56 pages)](https://docs.api.box/_llms/cn.md): Documentation for Chinese.