API Docs


gcui-art/suno-api currently mainly implements the following APIs:

- `/api/generate`: Generate music
- `/v1/chat/completions`: Generate music - Call the generate API in a format 
  that works with OpenAI's API.
- `/api/generate_lyrics`: Generate lyrics based on prompt
- `/api/generate_lyrics_pair`: Generate a pair of lyrics based on prompt
- `/api/get_lyrics`: Get lyrics status by ID
- `/api/get`: Get music information based on the id. Use "," to separate multiple 
    ids.  If no IDs are provided, all music will be returned.
- `/api/get_limit`: Get quota Info
- `/api/generate_stems`: Make stem tracks (separate audio and music track)
- `/api/get_aligned_lyrics`: Get list of timestamps for each word in the lyrics
- `/api/clip`:  Get clip information based on ID passed as query parameter `id`
- `/api/concat`: Generate the whole song from extensions
- `/api/persona`: Get persona information and clips based on ID and page number
- `/api/convert_wav/{id}`: Start converting an audio clip to WAV format
- `/api/wav_file/{id}`: Get WAV file URL for converted audio clip
 - `/api/wav_file/{id}`: Get WAV file URL for converted audio clip
 - `/api/video/generate/{id}/status`: Get video generation status for a clip
- `/api/tags/recommend`: Get recommended tags for music generation

Feel free to explore the detailed API parameters and conduct tests on this page.

Details of the API and testing it online

🔐 API 鉴权说明

仅支持 x-api-key 方式鉴权。请在请求头添加 x-api-key,其值需与服务端环境变量 SUNO_API_KEY 一致。

如果未设置 SUNO_API_KEY,API 将跳过鉴权(仅适用于开发环境)。

This is just a demo, bound to a test account. Please do not use it frequently, so that more people can test online.

💡 提示:如果您的服务器设置了 SUNO_API_KEY 环境变量,请在此处输入相同的密钥。 如果不设置,API 将跳过鉴权验证。