Account usage
June 3, 2026 (November 16, 2026)
Table of contents
Token and credit usage for an account — raw billing events plus per-type and per-song summaries, aggregated per UTC day.
https://api.useapi.net/v1/flowmusic/accounts/usage?email=
Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
API tokenis required, see Setup useapi.net for details.
Query Parameters
email(required) is which configured account to report on.
Responses
-
{ "email": "user@email.com", "events": [ { "type": "producer-usage", "amount": 60, "conversation_id": "11112222-3333-4444-8555-666677778888", "conversation_title": "Sample Song", "event_at": "2026-06-01T00:00:00", "max_created_at": "2026-06-01T18:42:55.123456Z", "_account_email": "user@email.com" } ], "summary": { "by_type_tokens": { "daily-free": 1440, "riffusion": 60, "producer-usage": 1200, "grant": 7200 }, "by_type_credits": { "daily-free": 120, "riffusion": 5, "producer-usage": 100, "grant": 600 }, "total_charged_credits": 105, "total_received_tokens": 8640, "per_conversation": [ { "conversation_id": "11112222-3333-4444-8555-666677778888", "title": "Sample Song", "email": "user@email.com", "tokens": 60, "credits": 5 } ] } }eventslists per-day usage rows, aggregated per UTC day. Each row carries atype, anamountin tokens, theconversation_id/conversation_titleit belongs to,event_at(start of the UTC day), andmax_created_at(the latest actual event time in that day).summary.by_type_tokensandby_type_creditstotal the amounts per event type (credits are tokens / 12).total_charged_creditssums the charged types (producer-usage,riffusion).total_received_tokenssums grants and free allowances.per_conversationbreaks the spend down per song. See Flow Music pricing for plan allowances and per-generation costs.
-
401 Unauthorized — invalid API token.
-
404 — account not configured.
Model
The account’s billing events, grouped by UTC day, plus totals by type and by song in tokens and credits.
The account's usage events and totals, field by field
{
email: string
events: Array<{
type: string // e.g. 'producer-usage' | 'riffusion' | 'daily-free' | 'grant'
amount: number // tokens
conversation_id: string | null
conversation_title: string | null
event_at: string // start of the UTC day this row is bucketed into
max_created_at: string // latest actual event time in that day
_account_email: string
}>
summary: {
by_type_tokens: Record<string, number>
by_type_credits: Record<string, number> // tokens / 12
total_charged_credits: number
total_received_tokens: number
per_conversation: Array<{
conversation_id: string
title: string | null
email: string | null
tokens: number
credits: number
}>
}
}
Examples
-
curl -H "Authorization: Bearer YOUR_API_TOKEN" \ "https://api.useapi.net/v1/flowmusic/accounts/usage?email=user@email.com" -
import requests r = requests.get('https://api.useapi.net/v1/flowmusic/accounts/usage', headers={'Authorization': 'Bearer YOUR_API_TOKEN'}, params={'email': 'user@email.com'}) print(r.status_code, r.json())