GET /v1/generations

Retrieve a paginated list of your music generations, sorted by most recent first.

Instrumental tracks appear in this list too, as do Reimagine and Remove vocals tracks. Filter to just one kind with ?type=music, ?type=instrumental, ?type=reimagine or ?type=remove_vocals.

Request

GET https://pub.finetuning.ai/v1/generations

Headers

Header	Type	Required	Description
`X-API-Key`	string	Yes	Your API key

Query parameters

Parameter	Type	Default	Description
`limit`	number	`20`	Number of results (1–99)
`offset`	number	`0`	Pagination offset
`status`	string	—	Filter by status: `pending`, `processing`, `completed`, `failed`
`type`	string	—	Filter by type: `music`, `instrumental`, `reimagine` or `remove_vocals`. Omit for all

Example

curl "https://pub.finetuning.ai/v1/generations?limit=10&status=completed" \
  -H "X-API-Key: ft_live_your_key_here"

Response

200 OK

{
  "data": {
    "generations": [
      {
        "id": "gen_abc123",
        "title": "lofi chill piano night",
        "prompt": "lofi chill piano night",
        "type": "music",
        "status": "completed",
        "audioUrl": "https://media.finetuning.ai/audio/gen_abc123.mp3",
        "duration": 120,
        "isPublic": false,
        "playCount": 0,
        "likeCount": 0,
        "parameters": {
          "bpm": 85,
          "duration": 120,
          "keyscale": "C minor",
          "timesignature": 4,
          "seed": 1234567
        },
        "createdAt": "2025-01-15 10:30:00",
        "completedAt": "2025-01-15T10:30:27.261Z"
      },
      {
        "id": "gen_def456",
        "title": "modern country instrumental",
        "prompt": "modern country instrumental, acoustic guitar strumming, pedal steel guitar, fiddle melody",
        "type": "music",
        "status": "completed",
        "audioUrl": "https://media.finetuning.ai/audio/gen_def456.mp3",
        "duration": 120,
        "isPublic": false,
        "playCount": 0,
        "likeCount": 0,
        "parameters": {
          "bpm": 110,
          "duration": 120,
          "keyscale": "G major",
          "timesignature": 4,
          "seed": 1951074202
        },
        "createdAt": "2025-01-14 14:20:00",
        "completedAt": "2025-01-14T14:20:16.623Z"
      }
    ],
    "hasMore": true,
    "nextOffset": 10
  }
}

Response fields

Field	Type	Description
`data.generations`	array	Array of generation objects
`data.generations[].id`	string	Unique generation ID (UUID)
`data.generations[].title`	string	Generation title
`data.generations[].prompt`	string	The tags/prompt used
`data.generations[].type`	string	`music`, `instrumental`, `reimagine` or `remove_vocals`
`data.generations[].status`	string	`pending`, `processing`, `completed`, `failed`
`data.generations[].audioUrl`	string \| null	Audio download URL (available when `completed`)
`data.generations[].duration`	number	Track duration in seconds
`data.generations[].isPublic`	boolean	Whether the generation is publicly visible
`data.generations[].playCount`	number	Number of plays
`data.generations[].likeCount`	number	Number of likes
`data.generations[].parameters`	object	Generation parameters (bpm, duration, keyscale, timesignature, seed)
`data.generations[].createdAt`	string	Creation timestamp
`data.generations[].completedAt`	string \| null	Completion timestamp (ISO 8601)
`data.hasMore`	boolean	Whether more results are available
`data.nextOffset`	number	Offset to use for the next page

Errors

Code	Status	Description
`MISSING_API_KEY`	401	X-API-Key header was not provided
`INVALID_API_KEY`	401	API key is malformed, revoked, or does not exist
`INTERNAL_ERROR`	500	Unexpected server error