List clips

June 3, 2026 (November 16, 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": "user@email.com",
      "clips": [
        {
          "clip": "user:1234-user@email.com-clip: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 user@email.com in error state: refresh token rejected",
      "code": 596
    }
    

Model

One page of the account’s clips, each with its id, title, lyrics, length and image, and the offset of the next page in next.

One page of the account's clips, field by field
{
  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