workbuddy
title: WorkBuddy chave de terceiros — Guia de modelos personalizados APIMaster.ai description: Como adicionar uma chave OpenAI-compatible da APIMaster.ai no WorkBuddy. Settings → Models → Add Model: Endpoint, API Key e Model Name; depois selecione o modelo no chat.
WorkBuddy é um agente de IA para desktop. Conecte a APIMaster.ai pela API compatível com OpenAI em Custom Models.
Primeiro obtenha uma API Key. A chave fica só em
%USERPROFILE%\.workbuddy\models.jsonou~/.workbuddy/models.json.
Pré-requisitos
- WorkBuddy instalado
- API Key no console
- model id do marketplace (ex.:
gpt-5.6-sol)
Passo 1 — Abrir configuração de modelos
Opção A (recomendada) — seletor de modelo do chat:
- Clique no nome do modelo ao lado da caixa de entrada
- No final do menu, Configure custom models

Opção B — em Settings:
- Abra Settings
- Selecione Models
- Em CUSTOM MODELS, + Add Model

Arquivo local: Windows %USERPROFILE%\.workbuddy\models.json / macOS·Linux ~/.workbuddy/models.json
Passo 2 — Dados de conexão APIMaster
Diálogo Add Model (OpenAI-compatible API required):
| Campo | Valor |
|---|---|
| Provider | Custom |
| Endpoint | https://apimaster.ai/v1 (/v1 obrigatório) |
| API Key | Sua chave APIMaster |
| Model Name | model id exato do marketplace |
Advanced Settings: Tool Calling ✅ / Image Input ✅ / Reasoning opcional / Custom Protocol ❌

Clique em Save. O Model Name deve coincidir exatamente com o id do marketplace.
Passo 3 — Selecionar no chat
- Abra o seletor de modelos
- Em Custom Models, escolha o modelo adicionado
- Envie uma mensagem de teste
- O nome do modelo ao lado da resposta = sucesso

Exemplos de model id
| model id | Notes |
|---|---|
gpt-5.6-sol |
GPT example in screenshots |
gpt-5.4 / gpt-5.5 |
GPT family |
claude-sonnet-4-6 |
Claude Sonnet |
claude-opus-4-8 |
Claude Opus |
deepseek-v4-pro / deepseek-v4-flash |
DeepSeek |
minimax-m3 / kimi-k3 |
Other popular models |
Copy ids from the marketplace.
Solução de problemas
| Problema | Correção |
|---|---|
| 401 | Cole de novo a API Key e Save |
| 404 | Recopie o Model Name |
| Timeout | Endpoint = https://apimaster.ai/v1 |
| Custom Models vazio | Confirme Save; reinicie o WorkBuddy |
| Falha de tools | Ative Tool Calling |
| Não acha as configs | Configure custom models ou Settings → Models → + Add Model |
Checklist
- WorkBuddy instalado
- Provider = Custom
- Endpoint =
https://apimaster.ai/v1 - Model Name do marketplace
- Tool Calling se necessário + Save
- Selecionável em Custom Models e responde