> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WorkBuddy

> Configure o AIHubMix no WorkBuddy e use qualquer modelo suportado pelo AIHubMix.

O WorkBuddy oferece suporte a modelos personalizados compativeis com OpenAI. Depois de adicionar o AIHubMix, voce pode selecionar modelos GPT, Claude, Gemini, DeepSeek, GLM e outros modelos do AIHubMix.

## Preparacao

* Instale e abra o [WorkBuddy](https://www.codebuddy.cn/work/).
* Crie uma API Key no [console do AIHubMix](https://aihubmix.com/token), geralmente `sk-***`.
* Copie o ID do modelo desejado na lista de modelos do AIHubMix.

## Configurar o AIHubMix na interface

No canto inferior direito da caixa de entrada, clique no seletor atual, por exemplo **Auto**.

<img src="https://mintcdn.com/aihubmix/hUWPsUQx34d5ps0-/public/cn/WorkBuddy-new-01.png?fit=max&auto=format&n=hUWPsUQx34d5ps0-&q=85&s=23bec09ea72b5e1b648177767cbde637" alt="Abrir seletor de modelos do WorkBuddy" width="1920" height="1030" data-path="public/cn/WorkBuddy-new-01.png" />

Role ate o final, selecione **Configure custom models**, clique em **Add Model** e escolha **Custom** em **Provider**.

<img src="https://mintcdn.com/aihubmix/hUWPsUQx34d5ps0-/public/cn/WorkBuddy-new-02.png?fit=max&auto=format&n=hUWPsUQx34d5ps0-&q=85&s=688011a1c31e25045e159e9dc8190a80" alt="Abrir modelos personalizados" width="1920" height="1030" data-path="public/cn/WorkBuddy-new-02.png" />

<img src="https://mintcdn.com/aihubmix/hUWPsUQx34d5ps0-/public/cn/WorkBuddy-new-03.png?fit=max&auto=format&n=hUWPsUQx34d5ps0-&q=85&s=1329120913f2155da65c2f7d357a282f" alt="Escolher o provedor Custom" width="1920" height="1030" data-path="public/cn/WorkBuddy-new-03.png" />

* **Endpoint**: `https://aihubmix.com/v1`; se necessario, `https://api.inferera.com/v1`.
* **API Key**: a chave criada no [console do AIHubMix](https://aihubmix.com/token).
* **Model Name**: o ID do modelo, por exemplo `gpt-5.5`.
* **Advanced Settings**: ative **Tool Calling**, **Image Input** ou **Reasoning** apenas para recursos suportados.

Clique em **Save** e escolha o modelo em **Custom Models**.

<img src="https://mintcdn.com/aihubmix/hUWPsUQx34d5ps0-/public/cn/WorkBuddy-new-04.png?fit=max&auto=format&n=hUWPsUQx34d5ps0-&q=85&s=d5560d438a48fbfbb7ca07d8223eb9de" alt="Preencher configuracao do WorkBuddy" width="1920" height="1030" data-path="public/cn/WorkBuddy-new-04.png" />

<img src="https://mintcdn.com/aihubmix/hUWPsUQx34d5ps0-/public/cn/WorkBuddy-new-05.png?fit=max&auto=format&n=hUWPsUQx34d5ps0-&q=85&s=c3446153d25197ee20a5b9fab75a0821" alt="Selecionar modelo personalizado" width="1920" height="1030" data-path="public/cn/WorkBuddy-new-05.png" />

## Adicionar um modelo por arquivo de configuracao

Edite `%USERPROFILE%\.workbuddy\models.json`:

```json theme={null}
[{"id":"gpt-5.5","name":"gpt-5.5","vendor":"Custom","url":"https://aihubmix.com/v1","apiKey":"sk-***","supportsToolCall":true,"supportsImages":true,"supportsReasoning":false,"useCustomProtocol":false}]
```

Para o endereco de reserva:

```json theme={null}
"url": "https://api.inferera.com/v1"
```

`id` e `name` sao o ID do modelo; `vendor` e `Custom`; `apiKey` e a chave AIHubMix. `supportsImages` e `supportsToolCall` correspondem a **Image Input** e **Tool Calling**. Reinicie o WorkBuddy ou abra novamente o seletor.

## Verificar a configuracao

Selecione o modelo e envie uma mensagem curta. Uma resposta confirma que ele esta configurado.

<img src="https://mintcdn.com/aihubmix/hUWPsUQx34d5ps0-/public/cn/WorkBuddy-new-06.png?fit=max&auto=format&n=hUWPsUQx34d5ps0-&q=85&s=d3cae4ea3b34d533d42d535e224cdcba" alt="Verificar resposta no WorkBuddy" width="1920" height="1030" data-path="public/cn/WorkBuddy-new-06.png" />

Se **Image Input** estiver ativado para um modelo compativel, envie uma imagem para testar.

<img src="https://mintcdn.com/aihubmix/hUWPsUQx34d5ps0-/public/cn/WorkBuddy-new-07.png?fit=max&auto=format&n=hUWPsUQx34d5ps0-&q=85&s=5ec910ae65fb3d929a34697473065fd2" alt="Verificar entrada de imagem" width="1920" height="1030" data-path="public/cn/WorkBuddy-new-07.png" />

## Perguntas frequentes

**Por que escolher Custom?**
O AIHubMix usa uma interface compativel com OpenAI, portanto exige endpoint, API Key e nome do modelo. Provedores integrados podem usar automaticamente os proprios enderecos.

**O modelo nao aparece apos salvar.**
Abra o seletor novamente e procure **Custom Models**. Confira **Save**, o nome do modelo e se `%USERPROFILE%\.workbuddy\models.json` e um JSON valido.

**A solicitacao falha.**
Confira `/v1`, a API Key e o ID do modelo. Se o endereco principal estiver indisponivel, use `https://api.inferera.com/v1`.

Ultima atualizacao: 2026-07-10
