List clips

June 3, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

List the clips generated on a Flow Music account, most recent first. Paginated by offset.

https://api.useapi.net/v1/flowmusic/music

Request Headers 

Authorization: Bearer {API token}
Content-Type: application/json

Query Parameters

  • email is optional, which configured account to list. Defaults to an available account.
  • limit is optional, the page size, 1–100 (default 20).
  • offset is optional, the page offset, ≥ 0 (default 0).

Responses

  • 200 OK

    {
  "email": "[email protected]",
  "clips": [
    {
      "clip": "user:[email protected]:12ab34cd-...",
      "title": "Morning Sun",
      "lyrics": "[Verse 1]\n...",
      "duration_s": 173.03,
      "image_url": "https://storage.googleapis.com/..."
    }
  ],
  "limit": 20,
  "offset": 0,
  "next": 20
}
    • next is the offset to request for the following page, or null when this was the last page.

  • 401 Unauthorized — invalid API token.

  • 596 Account Error

    The account targeted by email is in an error state and can’t be used — re-add it via POST /accounts. The error field returns whatever reason was recorded for the account.

    {
  "error": "Account [email protected] in error state: refresh token rejected",
  "code": 596
}

Model 

{
  email: string
  clips: Array<{
    clip: string                   // encoded clip asset id — use with /music/download and /music/edit
    title: string | null
    lyrics: string | null
    duration_s: number | null
    image_url: string | null
  }>
  limit: number
  offset: number
  next: number | null              // offset for the next page, or null when this was the last page
}

Examples 

  • curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v1/flowmusic/music?limit=10&offset=0"

  • import requests
response = requests.get(
    'https://api.useapi.net/v1/flowmusic/music',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    params={'limit': 10, 'offset': 0}
)
print(response.status_code, response.json())

Try It