WorkBuddy is a desktop AI agent workbench. You can connect it to Model Studio using Pay-as-you-go, Coding Plan, Token Plan Personal Edition, or Token Plan Team Edition.
Install WorkBuddy
Go to the WorkBuddy official website, click Download, and download the installer for your operating system. After installation, follow the on-screen instructions to sign in to your WorkBuddy account. You can sign in with a Google, GitHub, or email account.
Configure credentials
- Click the model selector at the bottom of the conversation interface and click Configure custom models at the bottom of the list. You can also open Settings from the avatar in the lower-left corner and select Model in the left navigation.
- Click Add model and select Custom as the provider.
- Enter the API address, API key, and model name. You can click Test connection to verify connectivity.
- Click Save.
- Token Plan Personal Edition: Deducts personal Credits based on token consumption.
- Token Plan Team Edition: Seat-based subscription that deducts Credits based on token consumption.
- Coding Plan: Fixed monthly subscription billed by the number of model calls.
- Pay-as-you-go: Postpaid billing based on actual usage.
- The API address is not completed automatically. Enter the complete Chat Completions address (ending with
/chat/completions), as shown in the plan configurations below. - Custom models support only the OpenAI-compatible Chat Completions protocol. Responses API and Anthropic protocols are not supported.
Token Plan Personal Edition
| Parameter | Description |
|---|---|
| API address | https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions |
| API key | Token Plan Personal Edition dedicated API key. |
| Model name | Enter a Model Studio model name (for example, qwen3.7-plus). For available models, see Token Plan Personal Edition supported models. |
Token Plan Team Edition
| Parameter | Description |
|---|---|
| API address | https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions |
| API key | Token Plan Team Edition dedicated API key. |
| Model name | Enter a Model Studio model name (for example, qwen3.7-plus). For available models, see Token Plan Team Edition supported models. |
Coding Plan
| Parameter | Description |
|---|---|
| API address | https://coding-intl.dashscope.aliyuncs.com/v1/chat/completions |
| API key | Coding Plan dedicated API key. |
| Model name | Enter a Model Studio model name (for example, qwen3.7-plus). For available models, see Coding Plan supported models. |
Pay-as-you-go
Enter your Model Studio API key. For available models, see models supported by the OpenAI-compatible API.
Select the API address for your region. The API key must match the selected region. Replace {WorkspaceId} in the URL with your actual Workspace ID:
- China (Beijing):
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions - Singapore:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions - US (Virginia):
https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions
Verify configuration
After saving, select the added model from the model selector at the bottom of the conversation interface and ask a question. A valid response confirms the setup.
For more information about WorkBuddy features and model configuration, see the WorkBuddy documentation.
FAQ
Error codes
If you encounter errors, see the FAQ for your billing plan:
- Pay-as-you-go: Error code troubleshooting
- Coding Plan: Coding Plan FAQ
- Token Plan Personal Edition: Token Plan Personal Edition FAQ
- Token Plan Team Edition: Token Plan Team Edition FAQ
Error: model does not exist
The model name is sent as the model parameter in the request and must exactly match a Model Studio model name (case-sensitive, without extra prefixes or suffixes). Check the model name in the custom model settings and try again.