Use os modelos do Alibaba Cloud Model Studio no Hermes Agent.
Início Rápido
Escolha o seu cliente e conclua a configuração.
CLI
- 1
Get an API key
- Token Plan Personal Edition: Criar ou visualizar API Key
- Token Plan Team Edition: Atribuir assento e obter API Key
- Pay-as-you-go: Chave de API do Model Studio
- Coding Plan: Chave de API do Coding Plan
- 2
Configure the model
Execute
hermes model, selecione o provedor do seu plano de cobrança, insira a chave de API e selecione um modelo.Token Plan
- Selecione
Qwen>Alibaba Cloud (Token Plan). - Insira a chave de API do Token Plan e mantenha a Base URL padrão.
- Selecione um modelo. Para modelos suportados, consulte os modelos suportados da Personal Edition e os modelos suportados da Team Edition.
Pay-as-you-go
- Selecione
Qwen>Qwen Cloud (Alibaba DashScope). - Insira uma chave de API do Model Studio.
- O exemplo a seguir usa Singapore. Insira
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1como Base URL e substitua{WorkspaceId}pelo seu Workspace ID real. - Selecione um modelo. Para modelos suportados, consulte Modelos suportados.
Coding Plan
- Selecione
Qwen>Alibaba Cloud (Coding Plan). - Insira a chave de API dedicada do Coding Plan e mantenha a Base URL padrão.
- Selecione um modelo. Para modelos suportados, consulte os modelos suportados do Coding Plan.
ObservaçãoA lista de provedores pode incluir modelos que o seu plano não suporta. A lista de modelos suportados do plano é a fonte oficial.
- Selecione
- 3
Verify
Execute o comando a seguir para verificar:
hermes chat -q "hello"
Desktop
- 1
Configure the model
Adicione a configuração do seu plano conforme descrito em Configurar com um arquivo de configuração ou conclua primeiro a configuração da CLI.
- 2
Select the model
Abra o Hermes Desktop, vá para Settings → Model e selecione o mesmo provedor e modelo.
Configurar com um arquivo de configuração
A lista de provedores em hermes model inclui o Alibaba Cloud Model Studio a partir da v2026.8.31. Se ele não estiver na lista, use as etapas a seguir.
- 1
Abra ou crie o arquivo de configuração
- macOS / Linux / WSL2:
~/.hermes/config.yaml - Windows:
%LOCALAPPDATA%\hermes\config.yaml
- macOS / Linux / WSL2:
- 2
Add the configuration
Substitua
YOUR_API_KEYpela chave de API desse plano (e{WorkspaceId}para pay-as-you-go) e adicione a configuração à seçãomodel.Token Plan
Compatível com OpenAI
model: default: auto provider: custom base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 api_key: YOUR_API_KEYCompatível com Anthropic
model: default: auto provider: custom base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEYPay-as-you-go
O exemplo a seguir usa Singapore.
Compatível com OpenAI
model: default: qwen3.8-max provider: custom base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 api_key: YOUR_API_KEYCompatível com Anthropic
model: default: qwen3.8-max provider: custom base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEYCoding Plan
Compatível com OpenAI
model: default: qwen3.7-plus provider: custom base_url: https://coding-intl.dashscope.aliyuncs.com/v1 api_key: YOUR_API_KEYCompatível com Anthropic
model: default: qwen3.7-plus provider: custom base_url: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEY - 3
Verify
Após salvar, execute
hermes chat -q "Hello"para verificar.
Códigos de erro
Se você encontrar um erro durante a configuração, consulte o FAQ do seu plano de cobrança:
- Token Plan: FAQ da Edição Pessoal · FAQ da Edição de Equipe
- Pagamento conforme o uso: Códigos de erro
- Coding Plan: FAQ do Coding Plan
Perguntas frequentes
Nenhum provedor do Model Studio no hermes model
Use o arquivo de configuração.
O modelo está indisponível
A lista de modelos em hermes model pode incluir modelos que o seu plano não suporta. Selecione um modelo da lista de modelos suportados do plano ou selecione Enter custom model name e insira um ID de modelo.
Como usar um plano de economia?
Os planos de economia usam o mesmo método de acesso do pagamento conforme o uso. O uso elegível é deduzido automaticamente. Para regras de dedução, consulte Planos de economia.