Skip to main content

How model accounts work

A model account is the AI account a runner signs in as to do a task's work: to read, think and write code. Every run of every task uses one. Without a model account that works, no task can run.

This page explains the ideas behind model accounts. For the steps, see Add a model account, Sign a model account in again and Pause or remove a model account. For every control on the screen, see Model accounts.

You find model accounts under Directory, then AI Accounts.

Terms​

TermMeaning
Model accountOne AI account runners sign in as. It has a Name, a Slug, a Provider and an Authentication.
NameThe label the account shows everywhere. You can change it.
SlugA short code Jaah picks when the account is added, for example k3x9q2. Fixed.
ProviderThe agent the account runs, for example Claude Code. Fixed once created.
AuthenticationHow the account signs in: Subscription (OAuth) or API key. Fixed once created.
QuotaHow much of a subscription's allowance is used, over 5 hours and over a week.
Sign-inA subscription's login on one node. Each node needs its own.
Auto-assignWhether the account runs tasks that allow any provider, or only tasks that pick its provider.
Max runnersThe most runners the account may run at once. Blank: a subscription follows your organization's Concurrent runners setting; an API key has no limit.

Subscription or API key​

An account authenticates in one of two ways, and the choice shapes everything else about it:

  • Subscription (OAuth) — a person signs in to an AI subscription on a node. The account reports its plan's quota. The sign-in belongs to that node and doesn't move to another: a second node needs its own sign-in. Nodes that mount the same NodeLink for model-account sign-ins share them, so any of those nodes can run the account.
  • API key — a key Jaah stores and never shows again. No sign-in, no node and no quota: it runs on any node and is billed per token by the AI provider.

Your plan sets which providers and authentication your organization may use; the form offers only those. An existing account whose provider and authentication are off your plan stays listed but runs no tasks. To get one, ask to change your plan.

How a run picks an account​

You don't pick a model account for a task. Each time a task starts a run, Jaah picks one of the accounts your organization has that is enabled, has room, and fits the task:

  • A task whose Provider is Any can run on any account with Auto-assign on.
  • A task that names a provider runs only on that provider's accounts. An account with Auto-assign off, shown with the explicit only chip, runs only such tasks.
  • A subscription runs only on a node where it has a working sign-in. An API-key account runs anywhere.
  • Subscriptions are picked first. An API-key account runs a task only when no subscription can take it.
  • A subscription runs at most your organization's Concurrent runners (Settings) at once, or its own Max runners when set. An API-key account has no limit unless its Max runners is set.
  • A subscription whose quota is used up, or nearly so, is skipped until its quota resets. So is a disabled account, and one whose provider or authentication your organization no longer allows.

If an account runs out or its sign-in is refused during a run, the run fails and uses one attempt; the task is queued again, and its next run picks from the accounts that still qualify. See How tasks work.

Health and lifecycle​

The round mark before each account says how it is doing: ● available, ▲ quota nearly used up, ✕ failing, ⊘ disabled. A quota cell shows — when it has no data, before the first reading or for an API key. Each subscription quota resets on its own clock, shown by ↻.

An account's life runs like this:

  1. Added, with an API key or a first sign-in on a node. It is enabled at once; a subscription's sign-in ends with Account added and enabled.
  2. Running tasks, its quota rising and resetting.
  3. Signed in again when a subscription's sign-in expires or is refused, with the row menu's Re-login or a node row's Login. An API key is replaced from Edit instead.
  4. Disabled to stop runs using it for a while, and Enabled again later. Nothing is lost.
  5. Removed with Delete, which takes its sign-in off every node and the shared folder. Removal can't be undone.

Who can do what​

You see the accounts you hold a role on, through your organization or the account's Access tab. Adding and signing in an account needs permission to add accounts; without it, Add account doesn't appear. Edit, Disable, Enable and Delete need the Org Owner or Org Admin role. An account's Owner is Organization or Personal. See How team and access work.

"No AI account"​

A task that can't start may say:

No AI account in your organization. Add one or ask an admin.

An AI account is a model account: without an enabled one, no run can start. It isn't a secret, and adding a secret doesn't fix it. Older tasks say the same as This task cannot be placed: … needs a credential account.

To fix it, select Add one in the message, or add a model account, an API key or a subscription login:

  1. In the sidebar, select Directory, then AI Accounts.
  2. Select Add account and follow Add a model account.

AI account disabled or AI accounts disabled means the account is there but off: enable it instead. Without permission to add accounts, Add account doesn't appear: ask an Org Owner or Org Admin to add one. The task itself has failed, so once an account is enabled, start it again.

Model accounts, credentials and billing​

A model account reaches the AI model itself. A secret reaches the services a task's work touches, such as Jira, Slack or GitHub. The cost of your own model accounts is billed by the AI provider, not by Jaah; work on the Jaah AI account is paid from your Jaah AI balance instead. See How plans and billing work.