# Suno API

## Docs

- [Chat Completions](https://mintlify.wiki/gcui-art/suno-api/api-reference/chat-completions.md): OpenAI-compatible endpoint for music generation
- [Get Clip](https://mintlify.wiki/gcui-art/suno-api/api-reference/clip.md): Retrieve the raw Suno clip object for a specific clip ID.
- [Concat](https://mintlify.wiki/gcui-art/suno-api/api-reference/concat.md): Concatenate an extended audio clip with its parent to produce a single complete song.
- [Custom Generate](https://mintlify.wiki/gcui-art/suno-api/api-reference/custom-generate.md): Generate two songs with full control over lyrics, style tags, and title.
- [Extend Audio](https://mintlify.wiki/gcui-art/suno-api/api-reference/extend-audio.md): Extend an existing audio clip with new content, continuing from any point in the song.
- [Generate](https://mintlify.wiki/gcui-art/suno-api/api-reference/generate.md): Generate two songs from a text description using Suno's AI.
- [Generate Lyrics](https://mintlify.wiki/gcui-art/suno-api/api-reference/generate-lyrics.md): Generate lyrics from a text prompt, without creating audio.
- [Generate Stems](https://mintlify.wiki/gcui-art/suno-api/api-reference/generate-stems.md): Split an existing song into separate vocal and instrumental stem tracks.
- [Get Songs](https://mintlify.wiki/gcui-art/suno-api/api-reference/get.md): Retrieve audio info for one or more songs by ID, or fetch your full song library.
- [Get Aligned Lyrics](https://mintlify.wiki/gcui-art/suno-api/api-reference/get-aligned-lyrics.md): Retrieve word-level timestamps that align the lyrics of a song to its audio.
- [Get Credit Limit](https://mintlify.wiki/gcui-art/suno-api/api-reference/get-limit.md): Check your remaining Suno credits and billing usage for the current period.
- [Get Persona](https://mintlify.wiki/gcui-art/suno-api/api-reference/persona.md): Retrieve paginated information about a Suno persona by ID.
- [Authentication](https://mintlify.wiki/gcui-art/suno-api/configuration/authentication.md): How Suno API authenticates with Suno.com using your browser session cookie.
- [CAPTCHA solving](https://mintlify.wiki/gcui-art/suno-api/configuration/captcha.md): How Suno API automatically solves hCaptcha challenges using 2Captcha and Playwright.
- [Environment variables](https://mintlify.wiki/gcui-art/suno-api/configuration/environment-variables.md): All environment variables available to configure Suno API.
- [Deployment](https://mintlify.wiki/gcui-art/suno-api/deployment.md): Deploy Suno API to Vercel, Docker Compose, or run it locally.
- [Agent integration](https://mintlify.wiki/gcui-art/suno-api/guides/agent-integration.md): Use Suno API as a tool inside AI agents and platforms including OpenAI GPTs, Coze, and LangChain.
- [Custom Mode](https://mintlify.wiki/gcui-art/suno-api/guides/custom-mode.md): Provide your own lyrics, style tags, and title for full control over generated music.
- [Generating music](https://mintlify.wiki/gcui-art/suno-api/guides/generate-music.md): Send a text prompt to Suno API and get back a playable audio file.
- [Introduction](https://mintlify.wiki/gcui-art/suno-api/introduction.md): Suno API is an unofficial open-source REST API wrapper for suno.ai, enabling programmatic music generation before an official API exists.
- [Quickstart](https://mintlify.wiki/gcui-art/suno-api/quickstart.md): Make your first Suno API call in under ten minutes.

## OpenAPI Specs

- [openapi](https://mintlify.wiki/gcui-art/suno-api/api-reference/openapi.json)