Suno API
gcui-art/suno-apiReviewed by AI
Checked by RepoPicks Radar on
RepoPicks Radar found strong risk signals in this project. It stays visible so you can read the evidence, but it is left out of recommendations and only appears in the rankings of the “With alerts” filter.
What is Suno API?
Suno has no public API, so this project builds one: a small server you host that signs in to Suno with your own session cookie, gets past the site's CAPTCHA with the paid 2Captcha service, and then answers simple requests to make songs, write lyrics, extend a track, split stems or check your remaining credits. It is aimed at programmers and AI agents, not at listeners. You still need your own Suno account and credits, plus money on a 2Captcha balance.
How easy is it to install Suno API?
D · terminal, several tools or a specific graphics card · Windows
- Windows D
- macOS D
- Linux D
Mac is the one the README recommends and it is still a D: you open the browser developer tools to copy a login cookie by hand, register and pay at 2Captcha, then run the server with Node.js or Docker Compose and call it over HTTP. Windows and Linux work the same way, but the README warns they "could get a pretty large number of CAPTCHAs".
Coming soon: install in 1 click with the RepoPicks app.
Suno API on GitHub
- Stars
- 3,306on Nov 10, 2026
- Downloads
- —all releases
- Growth
- +9stars in 6 days
Stars over time
Facts
- Runs on
- Windows, macOS, Linux
- You need to install
- Node.js, Docker
- To build from source
- Node.js, Docker
- Disk space
- 100 MB–500 MB · estimate
- Accounts or keys
- Suno session cookie copied from your browser, 2Captcha (paid CAPTCHA-solving service, ruCaptcha in Russia and Belarus)
- Cost
- Free, API costs extra · The code is free (LGPL-3.0 or later), but it needs a Suno account with credits and a topped-up balance on 2Captcha, which charges per solved CAPTCHA. Neither cost is stated in the repository.
- License
- LGPL-3.0 (Copyleft)
- Can replace
- Suno
- Last change on GitHub
- Mar 6, 2026
Suno API risk signals (6)
- Highbypasses captcha and bot detection
Getting around Suno's protections is the heart of the project. README features: "Solve CAPTCHAs automatically using 2Captcha and Playwright with rebrowser-patches" and "Automatically keep the account active"; package.json pulls in @2captcha/captcha-solver, rebrowser-playwright-core, ghost-cursor-playwright and user-agents, and .env.example has BROWSER_GHOST_CURSOR to "simulate smooth mouse movements". Defeating a site's CAPTCHA and bot detection breaks its terms of use and, in some countries, the law; the README itself says the project is "unofficial... intended for learning and research purposes only".
AI review
- AttentionDependencies with known vulnerabilities
Pinned dependencies with known vulnerabilities (OSV): next: GHSA-2464-fhr4-w9xw, GHSA-2xp9-vwfh-vxw4, GHSA-36qx-fr4f-26g5
automatic check
- Attentionyour login cookie lives in the server
Step 1 of the README tells you to copy the whole Cookie header from a logged-in suno.com session into SUNO_COOKIE (or into Vercel's dashboard), and the API also accepts cookies "in the Cookie header of your request". Anyone who reaches that server or that setting can act as you on Suno; the Dockerfile even bakes it in through a build argument (ARG SUNO_COOKIE).
AI review
- Attentionsuggests several free accounts to dodge limits
README: "This comes in handy when, for example, you want to use multiple free accounts at the same time", and the demo is "bound to a free Suno account, so it has daily usage limits". Using several free accounts to get past a service's quota is against the usual terms and can get the accounts closed.
AI review
- Attentionno releases and long pause
The checks record no releases at all and the last commit on 2026-03-06, 243 days before this analysis, with 109 open issues. A tool that depends on an undocumented private interface and on CAPTCHA tricks breaks when the site changes, so an unattended copy is likely to stop working.
AI review
- Infolicense described wrongly in the readme
The README features list says "Permissive open-source license, allowing you to freely integrate and modify", but the licence is LGPL-3.0-or-later, which the checks classify as copyleft: changes to the library itself have to stay under the same licence.
AI review
Evidence is shown in its original language.
What Radar could not check about Suno API
- Whether it still works with Suno today, since the site can change its pages, its protections and its CAPTCHA at any time.
- How much 2Captcha really costs per song generated.
- Whether Suno closes accounts used this way.
- Whether the flagged vulnerable version of Next.js (14.1.4) can be reached in your setup.
- Who owns the songs produced this way, which depends on Suno's own terms for your plan.