Kinetica docs
v1.0.0
Get help
● Operate · /admin

The operator console
one place for settings, customers and money.

A tour of /admin, page by page, in the order of its sidebar. The console is the MIKODES Admin Kit (packages/admin-kit/) with Kinetica's own sections and pages declared in src/server/admin/manifest.ts. Every change is written to the audit log.

Owner, manager, viewerTwo-factorAudit log

01Overview and Get started

Overview shows the setup progress, the status checks and the figures of the period: workspaces, accounts, paying workspaces, videos, finished and failed renders, minutes of video rendered, AI calls, credits spent, and uploads and renders on disk. Get started collects the few fields Kinetica needs before it goes live (product name, accent colour, support e-mail, AI model, public URL, e-mail sender), each linked to its full section.

The search box at the top (⌘/Ctrl+K) finds any setting, section or action.

Status checks (checks in the manifest):

CheckSeverity
Chrome and ffmpeg are installedBlocker
Public URL is httpsBlocker
Anthropic key is setWarning
ElevenLabs key is setWarning
Stripe keys are completeWarning
E-mail can be sentWarning
Plans are consistentWarning

02Setup: Brand, Legal, AI director, Voice, Server

Settings sections, explained field by field in Configuration and White label. A field pinned by a variable in .env (for example PUBLIC_URL) is shown locked.

03Money: Credits, Customer billing, Plans, Credit packs

  • Credits: the credit price of each action and the 4K multiplier.
  • Customer billing: "Sell plans and credit packs", the name on receipts, promotion codes at checkout.
  • Plans: the plan table and the plan form.
  • Credit packs: one-time top-ups.

All four are explained in Plans and credits.

04Product: Access, Studio, Client review, Workspaces, Videos, Users

  • Access: sign-up open or closed, welcome credits, announcement banner (Sign-up).
  • Studio: niches, looks, captions, formats, languages and the longest video on offer.
  • Client review: comment rate limit and link lifetime.
  • Workspaces: every customer workspace with its plan, subscription, credits, videos, members and creation date. "New workspace (client name)" with a plan creates one (agency mode). Per row: change the plan by hand, and "Credits…" to add or remove credits with a reason the workspace sees.
  • Videos: every video in every workspace with its last render. Open a workspace in the studio to change one.
  • Users: studio accounts, staff and customers. "Invite staff (e-mail)", a password reset link per user, disable an account, make or remove staff.
The console's Workspaces page with the New workspace form and a workspace row with plan and Credits actions

05Content: Music library and Templates

  • Music library: tracks people can put under their videos. Upload MP3, M4A or WAV (up to 30 MB), give each track a name, a mood (people pick music by mood) and a credit line (artist, title, licence) shown to users. Upload only music you own or hold a licence for. A new install has no tracks; videos render without music until you add some.
  • Templates: starting points every workspace sees in its template gallery. Start from a video or paste a storyboard (JSON, up to 1 MB); set name, short description, category, order in the gallery and "Shown to workspaces".

06System: Rendering, Public API, E-mail, Integrations, Notifications

  • Rendering: parallel renders, per-workspace limits, Chrome pages, watermark, GIF preview, keep days.
  • Public API: the API switch and the per-key rate limit (API).
  • E-mail: the sender and the "video is ready" e-mail.
  • Integrations: the six keys (Keys). Only owners can change them.
  • Notifications: where the console's own alerts go. Alerts are delivered to the webhook URL, signed with the signing secret (header x-mikodes-signature). The "Send alerts to" e-mail field is saved, but the console 1.0.0 delivers alerts by webhook only.

07Security & alerts, Export / Import

  • Security & alerts: your two-factor sign-in (authenticator app), where you are signed in, the team rule "Require two-factor for owners and managers", and alert rules for failing status checks.
  • Export / Import: a JSON file with every setting except secrets, to move a configuration between installs or keep a copy. An import shows exactly what changes before anything is applied. Only owners can import.

08Monitor: Revenue, Status, Audit log, History, and Kinetica's pages

PageWhat it shows
RevenuePayments recorded by the Stripe webhook, split into plan subscriptions and credit packs
StatusThe status checks with their last result, and the server
Audit logEvery sign-in and every change, who made it and what changed, with filters
HistorySaved versions of the settings; compare two versions and restore one
Render queueQueued, running, finished and failed renders. Cancel a render (its credits go back) or retry a failed one (free for the customer). Updates every 5 seconds while renders wait or run.
System healthApp and schema version, Chrome and ffmpeg (found or missing, version, path), data folder and free space (warns under 5 GB and under 1 GB), database sizes, uploads, the queue, the last render's speed, missing keys and what each switches on, the last backup with the backup commands
AI usageEvery AI call with model, input and output tokens and result; totals per model for 30 days. Your provider bills you for these.
StorageDisk used by uploads and renders, per workspace (each workspace may upload up to 2 GB)

09Console team

Team lists the people who can open the console, separate from studio accounts. Roles (packages/admin-kit/contract/manifest.ts):

RoleCan
OwnerEverything, including secrets (keys), members and imports
ManagerChange settings and use the product pages
ViewerRead only

Only owners add, change or remove members. Every sign-in and change is in the audit log. Lost owner password: recover-owner.js (First steps).