Docs

API documentation

This page is the full product reference for integrators (no separate Swagger UI). Authenticate with the X-API-Key header; webhook-style callbacks are available wherever we do heavy lifting asynchronously.

Each product has its own full reference: choose Suno AI, Heavo AI, or Music Distributor below.

API Keys

Suno AI

Suno-compatible gateway — generate, extend, poll. Full reference at /docs/suno-ai.

/docs/suno-ai

Heavo AI

Heavo AI music model: projects, generate, extend, stems, video. Served on Gard at /api/v1/heavo-ai — full reference at /docs/heavo-ai.

/docs/heavo-ai

Music Distributor

Uploads, catalog, releases, payouts, analytics — full public reference at /docs/music-distributor.

/docs/music-distributor

Authentication

Every request to Gard API requires the X-API-Key header. Create keys in the API Keys section of your dashboard.

Base URL

https://back.gard-api.org

curl -X POST "https://back.gard-api.org/api/v1/heavo-ai/projects?title=Demo" \
  -H "X-API-Key: gard_live_..."

Suno, Heavo, and Music Distributor accept X-API-Key: gard_… (create keys under Dashboard → API Keys).

SDKs & MCP

Skip the raw HTTP — drop in a typed SDK, or let Cursor / Claude call Gard tools directly over the Model Context Protocol.

Install

npm  i  @gard-api/sdk
pnpm add @gard-api/sdk
yarn add @gard-api/sdk
bun  add @gard-api/sdk

Use

import { Gard } from "@gard-api/sdk";

const gard = new Gard({ apiKey: process.env.GARD_KEY! });

const project = await gard.music.createProject({ title: "Demo" });
const gen = await gard.music.generate(project.id, {
  prompt: "dreamy synthwave 120bpm",
  model: "V1",
  callback_url: "https://app.example.com/hooks/heavo",
});

Fully typed. Requires Node ≥ 18 or any runtime with globalfetch. Covers Suno-compatible calls, Heavo AI (gard.music → /api/v1/heavo-ai), and gard.distributor.