GET /v1/generations
List your music generations
Retrieve a paginated list of your music generations, sorted by most recent first.
GET https://pub.finetuning.ai/v1/generations
| Header | Type | Required | Description |
|---|
X-API-Key | string | Yes | Your API key |
| Parameter | Type | Default | Description |
|---|
limit | number | 20 | Number of results (1–100) |
offset | number | 0 | Pagination offset |
status | string | — | Filter by status: pending, processing, completed, failed |
curl "https://pub.finetuning.ai/v1/generations?limit=10&status=completed" \
-H "X-API-Key: ft_live_your_key_here"
{
"data": {
"generations": [
{
"id": "gen_abc123",
"title": "lofi chill piano night",
"prompt": "lofi chill piano night",
"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",
"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
}
}
| 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[].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 |
| 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 |
