Suno.ai has no API, so this wrapper sends a browser instead

What it does

Suno-api is an unofficial bridge to Suno’s AI music generator. Because Suno does not offer a public API, the project spins up a headless browser via Playwright, logs in with your account cookie, and translates HTTP requests into clicks on the web app. It returns generated tracks, lyrics, stems, and metadata as JSON, effectively turning the Suno UI into a backend service.

The interesting bit

The real engineering is evasion, not music theory. It uses rebrowser-patches to avoid detection, routes hCaptcha challenges to the paid 2Captcha service, and even mimics OpenAI’s /v1/chat/completions schema so GPTs and Coze agents can call it as a native tool. It is essentially a polite, persistent scraper wearing an API costume.

Key highlights

• Exposes Suno creation features—generate, custom mode, extend, stems, lyrics, and aligned word timestamps—as HTTP endpoints.
• Keeps the Suno account session alive automatically so the cookie does not expire mid-workflow.
• Ships an OpenAI-compatible chat completions endpoint, letting LLM agents treat music generation like a standard function call.
• Supports per-request cookie overrides, so you can load-balance across multiple free-tier accounts.
• Deploys to Vercel or Docker, though the README warns that Docker disables GPU acceleration and may slow CAPTCHA solving on underpowered hardware.

Caveats

• Requires a paid 2Captcha subscription; there is no free CAPTCHA bypass, and the README notes that macOS hosts encounter fewer challenges than Linux or Windows.
• Relies on browser automation against an unofficial interface, meaning any change to Suno’s web app or Clerk authentication flow could break it without warning.
• The README is upfront that this is a stopgap “until the official API is available.”

Verdict

Worth a look if you are building an AI agent that needs to generate music and you are willing to trade maintenance overhead for early access. Skip it if you need a stable, officially supported integration or want to avoid recurring CAPTCHA costs.