Changelog

v1.1 — Current

New

• Zapier integration (private beta). Connect Finetuning to 8,000+ apps — auto-generate tracks and route finished MP3s anywhere, no code. See Zapier.
• POST /v1/generations accepts a webhook URL — we POST the completed (or failed) track to your endpoint, so you don't have to poll. See Webhooks.
• tags maximum increased from 500 → 700 characters.
• duration range widened from 10–180 → 5–210 seconds (free tier remains capped at 120).

Changed

• POST /v1/generations now returns 202 Accepted (previously 201 Created).
• Rate limiting on POST /v1/generations is now reported separately as GENERATION_RATE_LIMITED (10/min/user); RATE_LIMITED continues to cover read endpoints (60/min/user). See Rate Limits.

---

v1.0

Base URL: https://pub.finetuning.ai

Endpoints

• GET /v1/me — Account info and credit balance
• POST /v1/generations — Create a new music generation
• GET /v1/generations — List your generations
• GET /v1/generations/:id — Get generation details

Features

• Text-to-music generation with customizable parameters
• Tag-based genre and mood guidance
• BPM, key, scale, and energy controls
• Credit-based billing
• Rate limiting with standard headers

---