Changelog

v1.2 — Current

Bulk track deletion. POST /v1/generations/bulk-delete permanently deletes up to 100 tracks in one request, with per-item success/error reporting. See Bulk delete.
Playlists are now on the API. Five new endpoints:
- GET /v1/playlists — list your playlists
- GET /v1/playlists/:id — get a playlist with its tracks
- POST /v1/playlists/:id/tracks — add up to 100 tracks
- POST /v1/playlists/:id/tracks/bulk-remove — remove up to 100 tracks
- POST /v1/playlists/:id/tracks/move — move up to 100 tracks to another playlist
All bulk endpoints share the same model: 100 IDs max per request, partial success (one bad ID doesn't fail the batch), and a per-item errors array. New error codes ADD_FAILED and MOVE_FAILED are returned when zero items in a batch succeed. See Errors.

Playlist privacy rules are enforced server-side: public playlists may only contain public tracks, and private playlists may only contain your own tracks. The API never changes a track's visibility for you.
A bulk request counts as one request against the 60/min rate limit, regardless of how many IDs it carries.
The ft CLI supports all five endpoints: ft delete, ft playlists, and ft playlist add / remove / move. See the command reference.

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).

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.

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

More endpoints and features are coming soon — stay tuned!