How gcui-art/suno-api works
Suno AI API is a Next.js service that exposes Suno music-generation and related capabilities through HTTP endpoints, using a Suno account cookie for upstream access. The principal workflow is a caller submitting a generation request, its route invoking the Suno client, and the route returning the result; callers can then query or transform generated audio through separate endpoints. The README also documents OpenAI-compatible access, custom generation, lyrics, stems, extensions, and documentation UI. CAPTCHA handling and account keep-alive are described or visible in the client, though excerpts do not expose every internal call path.
Main entry points: SunoApi.ts Suno API client · generate/route.ts Generate music · custom_generate/route.ts Custom generation · completions/route.ts Chat completions
Components 25
Creation APIs
- Generate music
src/app/api/generate/route.ts - Custom generation
src/app/api/custom_generate/route.ts - Chat completions
src/app/v1/chat/completions/route.ts - Generate lyrics
src/app/api/generate_lyrics/route.ts
Audio APIs
- Extend audio
src/app/api/extend_audio/route.ts - Generate stems
src/app/api/generate_stems/route.ts - Concatenate audio
src/app/api/concat/route.ts - Audio lookup
src/app/api/get/route.ts - Clip lookup
src/app/api/clip/route.ts - Lyric alignment
src/app/api/get_aligned_lyrics/route.ts - Persona lookup
src/app/api/persona/route.ts - Quota lookup
src/app/api/get_limit/route.ts
Suno Client
- Suno API client
src/lib/SunoApi.ts - Request utilities
src/lib/utils.ts - Browser CAPTCHA flow
src/lib/SunoApi.ts
Web Experience
- Home page
src/app/page.tsx - API documentation
src/app/docs/page.tsx - Site header
src/app/components/Header.tsx - Site logo
src/app/components/Logo.tsx - Page section
src/app/components/Section.tsx - Site footer
src/app/components/Footer.tsx - Swagger viewer
src/app/components/Swagger.tsx
Other components
- API caller
- Suno service
- 2Captcha service
Connections 30
- API caller → Generate music: requests
README.md - API caller → Custom generation: requests
README.md - API caller → Chat completions: requests
README.md - API caller → Generate lyrics: requests
README.md - API caller → Extend audio: requests
README.md - API caller → Generate stems: requests
README.md - API caller → Concatenate audio: requests
README.md - API caller → Audio lookup: requests
README.md - API caller → Clip lookup: requests
README.md - API caller → Lyric alignment: requests
README.md - API caller → Persona lookup: requests
- API caller → Quota lookup: requests
README.md - Generate music → Suno API client: calls generate
src/app/api/generate/route.ts - Custom generation → Suno API client: calls custom_generate
src/app/api/custom_generate/route.ts - Chat completions → Suno API client: calls SunoApi
src/app/v1/chat/completions/route.ts - Generate lyrics → Suno API client: calls generateLyrics
src/app/api/generate_lyrics/route.ts - Extend audio → Suno API client: calls extendAudio
src/app/api/extend_audio/route.ts - Generate stems → Suno API client: calls generateStems
src/app/api/generate_stems/route.ts - Concatenate audio → Suno API client: calls concatenate
src/app/api/concat/route.ts - Audio lookup → Suno API client: calls get
src/app/api/get/route.ts - Clip lookup → Suno API client: calls clip lookup
src/app/api/clip/route.ts - Lyric alignment → Suno API client: calls alignment
src/app/api/get_aligned_lyrics/route.ts - Persona lookup → Suno API client: calls persona lookup
src/app/api/persona/route.ts - Quota lookup → Suno API client: calls quota lookup
src/app/api/get_limit/route.ts - Suno API client → Request utilities: uses helpers
src/lib/SunoApi.ts - Suno API client → Suno service: sends API requests
src/lib/SunoApi.ts - Suno API client → Browser CAPTCHA flow: launches
src/lib/SunoApi.ts - Browser CAPTCHA flow → 2Captcha service: submits challenges
src/lib/SunoApi.ts - Home page → Page section: renders
src/app/page.tsx - Site header → Site logo: renders
src/app/components/Header.tsx