An API for everyoneUser guide
Website ↗
User guideTool setup

WorkBuddy

Add your model service in WorkBuddy’s desktop settings without editing a configuration file.

Have these three details ready

With your app already installed, open Self-service on this website and sign in. Create or view your own API key, copy the API address shown there, and copy an exact model ID from Models and pricing. A website homepage, account password or marketing name is not a substitute. Check both account balance and key allowance.

API_HOST, YOUR_API_KEY and YOUR_MODEL_ID below are placeholders: replace each before use. Follow this article on whether to keep /v1; do not append /chat/completions or /responses. Examples do not connect automatically or contain your key.

1. Find model settings

Open Settings → Models, sometimes labelled Model management. In custom models, click Add model. Expand the account menu at the bottom left if the sidebar is collapsed.

2. Choose Custom and enter credentials

Choose Custom API/provider. Enter the full OpenAI-compatible address supplied by the platform, normally including /v1, and your API Key. Do not retain another vendor’s preset URL or append /chat/completions.

Field diagram · not an app screenshot
Provider
Custom API
Base URL
https://API_HOST/v1
API Key
YOUR_API_KEY
Model ID
YOUR_MODEL_ID

3. Set the model and capabilities

Enter the exact model ID, or fetch models first if that button is available. Enable tools, images and thinking only when supported. Use documented context/output limits. Leave Custom protocol off for this standard OpenAI-compatible setup.

4. Enable levels, then choose in chat

If the form has Supported thinking effort, declare only supported levels and keep the default on Auto initially. Save, select this custom model in chat, then choose effort there. Quick/Balanced/Ultimate modes are not universal effort levels for custom models.

5. Save and select the new model

Click Save, start a new task, open the model picker near the input and choose the model under Custom models. Saving does not ensure the current chat switches. If greyed out, complete the address and API Key in settings.

Check 1: receive a reply

Create an empty test folder, choose it as the workspace and start a new chat. Confirm the new provider and model are selected, then send the prompt below. A normal reply without an error confirms basic connectivity, not every agent feature. Tests incur normal API usage.

Reply only: Connection successful.

Expected: the app displays “Connection successful.” If you see a login page, an error or endless loading, use the checks below before sending again.

Check 2: read a real file

In that test folder, use a text editor to create hello.txt containing “API connection test 27”. Save it, then send the prompt below. If permission is requested, allow reading only this test folder.

Use the file-reading tool to open hello.txt in the current workspace and tell me its contents. Do not change any files.

Expected: a visible tool execution reading hello.txt, followed by an answer containing API connection test 27. A text answer alone is not evidence of a tool call. You may remove the test folder afterwards.

Troubleshoot by symptom

401 / Invalid API key

Check that the address and complete key belong to the same service and that the key is active. Never send support a full key.

404 / model not found

Check /v1, the exact model ID and the API format. A listed model is not a guarantee of support for every format.

429 / quota / balance

Check balance, key allowance and request rate; follow the returned error. More thinking effort cannot fix a quota problem.

Chat works but files cannot be read

Check model tool support, workspace permissions and the tool execution error.

No effort selector

Check capability declarations, the model and client version. Thinking support does not necessarily include adjustable effort.

Official references and scope

Configuration checked on 2026-11-08. Menus may change with updates; use these official references to verify details. Use the current connection information provided by this platform.