# docs.sunoapi.org ## Docs - [Suno API Documentation](https://docs.sunoapi.org/2517857m0.md): - [Suno API Quick Start](https://docs.sunoapi.org/suno-api/quickstart.md): Get started with Suno API in minutes to generate high-quality AI music, lyrics, and audio processing - Generate Music [Music Generation Callbacks](https://docs.sunoapi.org/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 Music [Music Extension Callbacks](https://docs.sunoapi.org/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 Music [Upload and Cover Audio Callbacks](https://docs.sunoapi.org/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 - Generate Music [Upload and Extend Audio Callbacks](https://docs.sunoapi.org/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 - Generate Music [Add Instrumental Callbacks](https://docs.sunoapi.org/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 - Generate Music [Add Vocals Callbacks](https://docs.sunoapi.org/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 - Generate Music [Music Cover Generation Callbacks](https://docs.sunoapi.org/suno-api/cover-suno-callbacks.md): When music cover generation is complete, the system will call this callback to notify results. - Generate Music [Replace Music Section Callbacks](https://docs.sunoapi.org/suno-api/replace-section-callbacks.md): Understand the callback mechanism for replace music section tasks - Suno Voice [Suno Voice Validation Phrase Callbacks](https://docs.sunoapi.org/suno-api/suno-voice-validate-callbacks.md): Receive POST callbacks when a Suno Voice validation phrase task is ready or fails. - Suno Voice [Suno Voice Generation Callbacks](https://docs.sunoapi.org/suno-api/suno-voice-generate-callbacks.md): Receive POST callbacks when a Suno Voice custom voice task succeeds or fails. - Suno Voice [Suno Voice Regenerate Phrase Callbacks](https://docs.sunoapi.org/suno-api/suno-voice-regenerate-callbacks.md): Receive POST callbacks when a regenerated Suno Voice validation phrase is ready or fails. - Generate Lyrics [Lyrics Generation Callbacks](https://docs.sunoapi.org/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 - WAV Conversion [WAV Format Conversion Callbacks](https://docs.sunoapi.org/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 - Vocal Removal [Audio Separation Callbacks](https://docs.sunoapi.org/suno-api/separate-vocals-from-music-callbacks.md): When vocal separation tasks are completed, the system will send results to your provided callback URL via POST request - Vocal Removal [MIDI Generation Callbacks](https://docs.sunoapi.org/suno-api/generate-midi-callbacks.md): System will call this callback when MIDI generation from separated audio is complete. - Music Video Generation [Music Video Generation Callbacks](https://docs.sunoapi.org/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 - [File Upload API Quickstart](https://docs.sunoapi.org/file-upload-api/quickstart.md): Get started with the File Upload API in minutes, supporting multiple upload methods - [Suno API 文档](https://docs.sunoapi.org/2517876m0.md): - [Suno API 快速开始](https://docs.sunoapi.org/cn/suno-api/quickstart.md): 几分钟内开始使用 Suno API 生成高质量的AI音乐、歌词和音频处理 - Generate Music [音乐生成回调](https://docs.sunoapi.org/cn/suno-api/generate-music-callbacks.md): 当音乐生成任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Generate Music [音乐扩展回调](https://docs.sunoapi.org/cn/suno-api/extend-music-callbacks.md): 当音乐扩展任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Generate Music [上传并翻唱音频回调](https://docs.sunoapi.org/cn/suno-api/upload-and-cover-audio-callbacks.md): 当上传并翻唱音频任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Generate Music [上传并扩展音频回调](https://docs.sunoapi.org/cn/suno-api/upload-and-extend-audio-callbacks.md): 当上传并扩展音频任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Generate Music [添加乐器回调](https://docs.sunoapi.org/cn/suno-api/add-instrumental-callbacks.md): 当乐器生成任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Generate Music [添加人声回调](https://docs.sunoapi.org/cn/suno-api/add-vocals-callbacks.md): 当人声生成任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Generate Music [音乐封面生成回调](https://docs.sunoapi.org/cn/suno-api/cover-suno-callbacks.md): 当音乐封面生成完成时,系统将调用此回调来通知结果。 - Generate Music [替换音乐分区回调](https://docs.sunoapi.org/cn/suno-api/replace-section-callbacks.md): 当音乐分区替换完成时,系统会调用此回调通知结果。 - Suno Voice [Suno Voice 验证短句回调](https://docs.sunoapi.org/cn/suno-api/suno-voice-validate-callbacks.md): Suno Voice 验证短句任务完成或失败时,通过 POST 回调接收结果。 - Suno Voice [Suno Voice 自建音色生成回调](https://docs.sunoapi.org/cn/suno-api/suno-voice-generate-callbacks.md): Suno Voice 自建音色任务成功或失败时,通过 POST 回调接收结果。 - Suno Voice [Suno Voice 重新生成验证短句回调](https://docs.sunoapi.org/cn/suno-api/suno-voice-regenerate-callbacks.md): 重新生成 Suno Voice 验证短句完成或失败时,通过 POST 回调接收结果。 - Generate Lyrics [歌词生成回调](https://docs.sunoapi.org/cn/suno-api/generate-lyrics-callbacks.md): 当歌词生成任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - WAV Conversion [WAV格式转换回调](https://docs.sunoapi.org/cn/suno-api/convert-to-wav-format-callbacks.md): 当WAV格式转换任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Vocal Removal [音频分离回调](https://docs.sunoapi.org/cn/suno-api/separate-vocals-from-music-callbacks.md): 当人声分离任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - Vocal Removal [MIDI 生成回调](https://docs.sunoapi.org/cn/suno-api/generate-midi-callbacks.md): 当从分离音频生成 MIDI 完成时,系统将调用此回调。 - Music Video Generation [音乐视频生成回调](https://docs.sunoapi.org/cn/suno-api/create-music-video-callbacks.md): 当音乐视频生成任务完成时,系统将通过POST请求将结果发送到您提供的回调URL - [文件上传 API 快速开始](https://docs.sunoapi.org/cn/file-upload-api/quickstart.md): 几分钟内开始使用文件上传 API,支持多种上传方式 ## API Docs - Generate Music [Generate Music](https://docs.sunoapi.org/suno-api/generate-music.md): Generate music with or without lyrics using AI models. - Generate Music [Extend Music](https://docs.sunoapi.org/suno-api/extend-music.md): Extend or modify existing music tracks. - Generate Music [Upload And Cover Audio](https://docs.sunoapi.org/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. - Generate Music [Upload And Extend Audio](https://docs.sunoapi.org/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. - Generate Music [Add Instrumental](https://docs.sunoapi.org/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. - Generate Music [Add Vocals](https://docs.sunoapi.org/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. - Generate Music [Get Music Generation Details](https://docs.sunoapi.org/suno-api/get-music-generation-details.md): Retrieve detailed information about a music generation task, including status, parameters, and results. - Generate Music [Recovery Audio](https://docs.sunoapi.org/suno-api/recovery-audio.md): Recover playable audio links for an existing music generation task. - Generate Music [Get Recovery Audio Details](https://docs.sunoapi.org/suno-api/get-recovery-audio-details.md): Query the status and recovered audio links of a recovery task. - Generate Music [Get Timestamped Lyrics](https://docs.sunoapi.org/suno-api/get-timestamped-lyrics.md): Retrieve timestamped lyrics for synchronized display during audio playback. - Generate Music [Boost Music Style](https://docs.sunoapi.org/suno-api/boost-music-style.md): This is an exclusive capability of V4_5. The style functionality of V4_5 has been significantly enhanced, as stated on the official website: - Generate Music [Generate Music Cover](https://docs.sunoapi.org/suno-api/cover-suno.md): Create personalized cover images for generated music. - Generate Music [Replace Music Section](https://docs.sunoapi.org/suno-api/replace-section.md): Replace a specific time segment within existing music. - Generate Music [Get Music Cover Details](https://docs.sunoapi.org/suno-api/get-cover-suno-details.md): Get detailed information about music cover generation tasks. - Generate Music [Generate Persona](https://docs.sunoapi.org/suno-api/generate-persona.md): Create a personalized music Persona based on generated music, giving the music a unique identity and characteristics. - Generate Music [Generate Mashup](https://docs.sunoapi.org/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.sunoapi.org/suno-api/suno-voice-validate.md): Generate the validation phrase required for the Suno Voice custom voice workflow. - Suno Voice [Suno Voice Get Verification Phrase](https://docs.sunoapi.org/suno-api/suno-voice-validate-info.md): Query the validation phrase generation result for a Suno Voice task. - Suno Voice [Suno Voice Create Custom Voice](https://docs.sunoapi.org/suno-api/suno-voice-generate.md): Generate a reusable Suno custom voice from the user's verification recording. - Suno Voice [Suno Voice Get Custom Voice Record](https://docs.sunoapi.org/suno-api/suno-voice-record-info.md): Query the custom Suno Voice generation result and obtain the generated voiceId. - Suno Voice [Suno Voice Regenerate Verification Phrase](https://docs.sunoapi.org/suno-api/suno-voice-regenerate.md): Regenerate the validation phrase for an existing Suno Voice task. - Suno Voice [Suno Voice Check Availability](https://docs.sunoapi.org/suno-api/suno-voice-check-voice.md): Check whether a generated Suno custom voice is available for use. - Generate Lyrics [Generate Lyrics](https://docs.sunoapi.org/suno-api/generate-lyrics.md): Create lyrics for music using AI models without generating audio tracks. - Generate Lyrics [Get Lyrics Generation Details](https://docs.sunoapi.org/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.sunoapi.org/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.sunoapi.org/suno-api/convert-to-wav-format.md): Convert existing music tracks to high-quality WAV format. - WAV Conversion [Get WAV Conversion Details](https://docs.sunoapi.org/suno-api/get-wav-conversion-details.md): Retrieve detailed information about a WAV format conversion task, including status and download link. - Vocal Removal [Vocal & Instrument Stem Separation](https://docs.sunoapi.org/suno-api/separate-vocals-from-music.md): Use Suno's official get‑stem API to split tracks created on our platform into clean vocal, accompaniment, or per‑instrument stems with state‑of‑the‑art source‑separation AI. - Vocal Removal [Get Audio Separation Details](https://docs.sunoapi.org/suno-api/get-vocal-separation-details.md): Retrieve detailed information about a vocal separation task, including status and download links. - Vocal Removal [Generate MIDI from Audio](https://docs.sunoapi.org/suno-api/generate-midi.md): Convert separated audio tracks into MIDI format with detailed note information for each instrument. - Vocal Removal [Get MIDI Generation Details](https://docs.sunoapi.org/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.sunoapi.org/suno-api/create-music-video.md): Generate an MP4 video with visualizations for a music track. - Music Video Generation [Get Music Video Details](https://docs.sunoapi.org/suno-api/get-music-video-details.md): Retrieve detailed information about a music video generation task, including status and download link. - Generate Speech [Generate Speech](https://docs.sunoapi.org/suno-api/generate-speech.md): Create a Suno Speech generation task. Supports **Simple** and **Advanced** modes, switched by `customMode`. The two modes have mutually exclusive fields — do not mix them. - [Get Remaining Credits](https://docs.sunoapi.org/suno-api/get-remaining-credits.md): Retrieve the current balance of available credits for your account. - [Base64 File Upload](https://docs.sunoapi.org/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.sunoapi.org/file-upload-api/upload-file-stream.md): :::info[] - [URL File Upload](https://docs.sunoapi.org/file-upload-api/upload-file-url.md): :::info[] - Generate Music [生成音乐](https://docs.sunoapi.org/cn/suno-api/generate-music.md): 使用AI模型生成带或不带歌词的音乐。 - Generate Music [延长音乐](https://docs.sunoapi.org/cn/suno-api/extend-music.md): 延长或修改现有音乐作品。 - Generate Music [上传并翻唱音乐](https://docs.sunoapi.org/cn/suno-api/upload-and-cover-audio.md): 此 API 通过在保留其核心旋律的同时将音轨转换为新样式来覆盖音轨。它结合了 Suno 的上传功能,使用户能够上传音频文件进行处理。预期的结果是刷新了具有新风格的音轨,同时保持了原始旋律的完整性。 - Generate Music [上传并扩展音乐](https://docs.sunoapi.org/cn/suno-api/upload-and-extend-audio.md): 此 API 在保留音频轨道原始样式的同时扩展了音轨。它包括 Suno 的上传功能,允许用户上传音频文件进行处理。预期的结果是更长的音轨,无缝地延续输入的风格。 - Generate Music [添加伴奏](https://docs.sunoapi.org/cn/suno-api/add-instrumental.md): 通过为上传的音频文件添加伴奏元素,生成现有音乐曲目的伴奏版本 - Generate Music [添加人声](https://docs.sunoapi.org/cn/suno-api/add-vocals.md): 通过为上传的音频文件添加人声元素,为现有的器乐音乐生成人声轨道 - Generate Music [获取音乐生成详情](https://docs.sunoapi.org/cn/suno-api/get-music-generation-details.md): 获取音乐生成任务的详细信息,包括状态、参数和结果。 - Generate Music [恢复音频](https://docs.sunoapi.org/cn/suno-api/recovery-audio.md): 为已有的音乐生成任务恢复可播放的音频链接。 - Generate Music [获取恢复音频详情](https://docs.sunoapi.org/cn/suno-api/get-recovery-audio-details.md): 查询恢复任务的状态与恢复出的音频链接。 - Generate Music [获取带时间戳的歌词](https://docs.sunoapi.org/cn/suno-api/get-timestamped-lyrics.md): 获取带时间戳的歌词,用于音频播放时的同步显示。 - Generate Music [提升音乐风格](https://docs.sunoapi.org/cn/suno-api/boost-music-style.md): 这是V4_5的独特功能。V4_5的风格功能已经得到显著增强,正如官方网站所述: - Generate Music [生成音乐封面](https://docs.sunoapi.org/cn/suno-api/cover-suno.md): 为生成的音乐创建个性化封面图像。 - Generate Music [替换音乐分区](https://docs.sunoapi.org/cn/suno-api/replace-section.md): 替换现有音乐的指定时间段。 - Generate Music [获取音乐封面详情](https://docs.sunoapi.org/cn/suno-api/get-cover-suno-details.md): 获取音乐封面生成任务的详细信息。 - Generate Music [生成 Persona](https://docs.sunoapi.org/cn/suno-api/generate-persona.md): 基于已生成的音乐创建个性化的音乐 Persona,为音乐赋予独特的身份和特征。 - Generate Music [混音生成](https://docs.sunoapi.org/cn/suno-api/generate-mashup.md): 使用AI模型将两个音频文件混合生成新的混音作品。 - Suno Voice [Suno Voice 生成验证短句](https://docs.sunoapi.org/cn/suno-api/suno-voice-validate.md): 生成 Suno Voice 自建音色流程所需的验证短句。 - Suno Voice [Suno Voice 获取验证短句](https://docs.sunoapi.org/cn/suno-api/suno-voice-validate-info.md): 查询 Suno Voice 任务的验证短句生成结果。 - Suno Voice [Suno Voice 自建音色生成](https://docs.sunoapi.org/cn/suno-api/suno-voice-generate.md): 根据用户录制的验证短句音频生成可复用的 Suno 自建音色。 - Suno Voice [Suno Voice 获取自建音色记录](https://docs.sunoapi.org/cn/suno-api/suno-voice-record-info.md): 查询 Suno Voice 自建音色生成结果,并获取生成的 voiceId。 - Suno Voice [Suno Voice 重新生成验证短句](https://docs.sunoapi.org/cn/suno-api/suno-voice-regenerate.md): 为已有 Suno Voice 任务重新生成验证短句。 - Suno Voice [Suno Voice 检查音色是否可用](https://docs.sunoapi.org/cn/suno-api/suno-voice-check-voice.md): 检查生成的 Suno 自建音色是否可用。 - Generate Lyrics [生成歌词](https://docs.sunoapi.org/cn/suno-api/generate-lyrics.md): 使用AI模型创建歌词内容,无需生成音频轨道。 - Generate Lyrics [获取歌词生成详情](https://docs.sunoapi.org/cn/suno-api/get-lyrics-generation-details.md): 获取歌词生成任务的详细信息,包括状态、参数和结果。 - Generate Sounds [生成声音](https://docs.sunoapi.org/cn/suno-api/generate-sounds.md): 创建 Sounds 生成任务,支持循环、BPM、调性和歌词字幕抓取等参数。 - WAV Conversion [转换为WAV格式](https://docs.sunoapi.org/cn/suno-api/convert-to-wav-format.md): 将现有音乐转换为高质量WAV格式。 - WAV Conversion [获取WAV转换详情](https://docs.sunoapi.org/cn/suno-api/get-wav-conversion-details.md): 获取WAV格式转换任务的详细信息,包括状态和下载链接。 - Vocal Removal [人声和乐器分离](https://docs.sunoapi.org/cn/suno-api/separate-vocals-from-music.md): 将音乐音轨分割为人声和伴奏两个独立的部分,或者分离各种乐器的声音。 - Vocal Removal [获取音频分离详情](https://docs.sunoapi.org/cn/suno-api/get-vocal-separation-details.md): 获取人声和乐器分离任务的详细信息,包括状态和下载链接。 - Vocal Removal [从音频生成 MIDI](https://docs.sunoapi.org/cn/suno-api/generate-midi.md): 将分离后的音轨转换为 MIDI 格式,为每个乐器提供详细的音符信息。 - Vocal Removal [获取 MIDI 生成详情](https://docs.sunoapi.org/cn/suno-api/get-midi-details.md): 检索 MIDI 生成任务的详细信息,包括所有检测到的乐器的完整音符数据。 - Music Video Generation [创建音乐视频](https://docs.sunoapi.org/cn/suno-api/create-music-video.md): 为音乐曲目生成带有可视化效果的MP4视频。 - Music Video Generation [获取音乐视频详情](https://docs.sunoapi.org/cn/suno-api/get-music-video-details.md): 获取音乐视频生成任务的详细信息,包括状态和下载链接。 - Generate Speech [生成语音](https://docs.sunoapi.org/cn/suno-api/generate-speech.md): 用于创建 Suno Speech 语音生成任务。支持 **Simple** 与 **Advanced** 两种模式,由 `customMode` 切换。两种模式字段互斥,不要混传。 - [获取剩余积分](https://docs.sunoapi.org/cn/suno-api/get-remaining-credits.md): 获取您账户当前可用的积分余额。 - [Base64 文件上传](https://docs.sunoapi.org/cn/file-upload-api/upload-file-base-64.md): :::info[] - [文件流上传](https://docs.sunoapi.org/cn/file-upload-api/upload-file-stream.md): :::info[] - [URL 文件上传](https://docs.sunoapi.org/cn/file-upload-api/upload-file-url.md): :::info[]