Account

GET /me

Return your account snapshot: the shared ecosystem balance and tier that jobs draw on, your rate, and which paid features your plan includes. This is the same balance the FluidTalk conversations spend and the same number the dashboard shows. Requires authentication.

Response — 200 OK

{
  "ownerId": "1d970780-…",
  "balance": 42.75,
  "tier": "pro",
  "planName": "Creator",
  "unitPrice": { "image": 0.016, "video": 0.08 },
  "features": { "ultraSafe": false }
}

Field	Type	Notes
ownerId	string	Your account id.
balance	number | null	Shared balance in tokens (1 token = $1). null when billing is inert or the balance authority is unreachable.
tier	string | null	Your plan tier. null when unavailable.
planName	string	The plan's customer-facing name — pro is sold as "Creator". Derived from the same normalisation the charge uses, so it can never disagree with your rate.
unitPrice	object	USD per produced copy on this plan, by media kind.
features	object	Paid features your plan includes. ultraSafe is Ultra Safe — Agency and higher. Check it before offering the option; a job that asks for a feature you don't have is refused 403.

Use this to show remaining balance before submitting a large batch. Job costs are debited per variant; a job that the balance can't cover is refused with 402 insufficient_balance. See Billing. Top-ups happen in the dashboard, not the API.