Tools
stirvid_status
Health check. Returns API reachability, generation-service reachability, billing reachability, and the current agent identity.
balance
Reads the current generation-account credit balance.
balance_history
Returns recent balance snapshots. Useful for spotting burn rate.
Key params: limit (default 20), since (ISO timestamp).
ledger_list
Lists entries in the credits ledger: automated purchases, manual top-ups, and adjustments.
Key params: limit, source (purchase | manual_topup | adjustment).
ledger_record
Records a manual funding event into the credits ledger. Used when you top up out of band.
Key params: amount_usd, source, note.
characters_list
Returns the character catalog. Filters for public, platform_ready.
generation_create
Creates a generation job.
Key params: image_url, video_url, mode (std | pro), sound (retain | silent), character_id.
generation_status
Polls a job by task_id. Returns status, progress, and (on completion) the signed output URL.
credits_adjust
Adjusts a user’s CREDITS balance. Support / ops use only.
Key params: user_id, delta, reason.