Guides

Every Suno API claims reliability; almost none define it. The framework for judging one: effective cost (list price ÷ success rate), billed-on-success, latency, and staying up when Suno changes.

Suno has no public self-serve API — here are the three ways to call it from code, and what makes a route production-ready.

A structured error taxonomy — input-rejected vs rate-limit vs generation-failed — each mapped to retry-or-fix and to whether you're billed. With a copy-paste retry/backoff wrapper in Python & Node.

A hosted MCP server (generate_song / wait_for_song / check_song) so agents make music in-conversation — with typed errors and no-charge-on-failure that make autonomous retries safe.

Async beats polling — receive and verify a Suno API webhook: HMAC-SHA256 check, replay protection, and idempotent handling, with Node & Python code.

gcui-art is great to prototype with — but captcha, cookie rotation, bans, and maintenance add up. When self-hosting is right, and when to stop.

Copy-paste functions to generate music from Python or Node: submit → poll (or webhook) → audio URL, with timeouts and error handling. Zero dependencies.

A developer's honest comparison: model strengths, how you access each via API, and how to choose for your app.

The self-hosted wrapper is unmaintained and its CAPTCHA flow broke on Suno's v5.5 UI. The 15-minute exit: /api/generate and /api/custom_generate keep their names — swap the base URL, add a key, delete the cookie/2captcha plumbing.

PiAPI dropped Suno. Here's the drop-in path: endpoint mapping (task → job), billed-only-on-success, and async webhooks, with copy-paste code.

Self-host gcui-art, Kie.ai, sunoapi.org, or Tunova? An opinionated rubric: effective cost (price ÷ success rate), billing on failures, reliability when Suno changes, and agent-readiness.

They share one API surface, so one guide covers both: taskId → job_id, Bearer → X-API-Key, callBackUrl → HMAC-signed webhooks — and billing that auto-refunds failed renders.

Specialist vs generalist, honestly: Kie.ai is cheaper per song and multi-model; Tunova bills only on success, is Suno-only, and ships a hosted MCP server. When each is the right pick.