Skip to the page

DocsAI workers

DocsAI workers

AI models and your own keys

Run AI workers on Projik’s built-in models, or on your own Anthropic, OpenAI or Google Gemini key. Who is billed, and what happens when a key stops working.

Team plan and aboveFor owners and admins

Every AI worker that Projik runs runs on one of two things:

  • Built in. Projik’s own models. What the worker uses comes out of your workspace’s monthly AI allowance. This is the default, and there’s nothing to set up.
  • Your own key. Your Anthropic, OpenAI or Google Gemini API key, on a model you choose. That provider bills you for the worker’s runs, and they don’t use the allowance.

You can mix the two, worker by worker. Everyone in the workspace can see which keys exist and which model each worker uses. Owners and admins change them.

Add a key#

  1. Open Settings › AI models.
  2. Beside Anthropic (Claude), OpenAI or Google Gemini, choose Add key.
  3. Paste the API key from your account with that provider and choose Save.

Projik checks the key with the provider before saving it. A key the provider refuses isn’t saved, and the message says what the provider answered.

A saved key is stored encrypted and never shown again. Settings shows only its last four characters and the day it was added. You can have one key for each provider.

  • Replace swaps in a new key, checked in the same way.
  • Remove deletes the key. Workers set to use it stop until you add a key again or switch them to built in.

Choose the models#

The workspace default#

Under New AI workers run on in Settings › AI models, choose Built in: Projik’s AI allowance or a model on one of your keys, then Save. Models are listed only for providers you’ve added a key for.

Every worker left on Workspace default follows this setting, including workers you add later.

One worker’s model#

  1. Open the worker’s page from People & AI.
  2. Under Who does its work, with Projik runs it chosen, pick from Model: Workspace default, Built in: Projik’s AI allowance, or a model on one of your keys.
  3. Choose Save.

A worker’s own choice wins over the workspace default. Choosing built in for one worker keeps it on Projik’s models even when the default is one of your keys, so you can run routine work on a cheaper model of your own and keep another worker built in.

The models you can choose#

Your keyModels
Anthropic (Claude)Claude Sonnet 5.5, Claude Opus 5.5, Claude Haiku 5.5
OpenAIGPT-5, GPT-4.1, GPT-4o
Google GeminiGemini 2.5 Pro, Gemini 2.5 Flash

The list is fixed to models that have been tested with AI workers. Built in has no model to pick: Projik chooses it.

Who is billed#

The worker runs onWho paysCounts against the AI allowance
Built inIncluded in your plan, up to the allowance, then token packsYes
Your own keyYour provider bills you directlyNo

Settings › AI models shows this month’s tokens on your own keys, so you can compare them with your provider’s bill. On a worker’s page, each run on your key is marked with the model and “your key”.

When a key stops working#

Projik never moves a worker from your key onto its own models. That would start spending your allowance without anyone choosing it. Instead the worker stops, and says why.

The provider refuses the key (it was revoked, or the account is out of credit). The run fails without a second try. The worker comments on the task that your key was refused, with the provider’s answer. In Settings › AI models the key shows when it last failed and why. Fix the key with the provider or use Replace, then start the task again.

The key was removed. The worker’s page says “It isn’t taking work”, with the reason. Invitations to it stay open for a person to pick up, and runs already queued are skipped. In the Model list its choice is marked “(not available)”. Add the key again, or choose another model for the worker.

The plan no longer includes your own keys. The same: the worker stops and its page says why. Your keys are kept, and the worker’s choice isn’t changed.

What always uses Projik’s models#

Your own keys are for AI workers only. These always run on Projik’s models and count against the allowance:

A worker that works on GitHub uses neither: the code agent in your repository runs on whatever you’ve set up there. A worker with its own agent uses whatever model that agent uses.

Plan#

Your own model keys need the Team plan or above, and are included in a new workspace’s trial. Free has no AI workers. If a workspace moves to Free, its keys are kept for when it upgrades.

    Type to search every page. ↑ ↓ to move, Enter to open.