diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/deepseek.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/deepseek.md new file mode 100644 index 0000000..a0abd2b --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/deepseek.md @@ -0,0 +1,91 @@ +--- +id: deepseek-api +title: DeepSeek API +--- + +# Guia de Configuração do DeepSeek + +## Visão Geral + +**DeepSeek** é um benchmark no campo de grandes modelos da China. + +A série DeepSeek-V3 atraiu atenção generalizada globalmente com desempenho de inferência altamente competitivo e preços de API extremamente baixos, tornando-se um dos modelos mais econômicos preferidos pelos desenvolvedores. + +Sua interface compatível com OpenAI torna a integração quase sem limiar e é um dos provedores domésticos mais comumente usados pelos usuários do PicoClaw. + +![Visão Geral do DeepSeek](/img/providers/deepseek-overview.png) + +Documentação Oficial: https://api-docs.deepseek.com/zh-cn/api/deepseek-api/ + +***Nota**: DeepSeek atualmente suporta apenas pay-as-you-go, sem planos de assinatura* + +*deepseek-chat atualmente corresponde ao DeepSeek-V3.2* + +## Obtendo Chave da API + +### Passo 1: Visitar Plataforma + +Acesse [Plataforma Open do DeepSeek](https://platform.deepseek.com/), registre-se e faça login. + +### Passo 2: Criar Chave da API + +1. Entre no Console → página **API Keys** +2. Clique em "Criar Chave da API" +3. Copie e salve com segurança + + *⚠️ **Nota**: A Chave da API é mostrada apenas uma vez, salve imediatamente.* + +## Configurando PicoClaw + +### Opção 1: Usando WebUI (Recomendado) + +Abra o WebUI do PicoClaw, vá para a página **Models** na navegação esquerda, clique em "Adicionar Modelo" no canto superior direito: + +![Adicionar Modelo](/img/providers/webuimodel.png) + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., deepseek | +| Identificador do Modelo | deepseek/deepseek-chat | +| Chave da API | Sua Chave da API do DeepSeek | +| URL Base da API | Deixe vazio (usa automaticamente o endpoint padrão) | + +Clique em "Adicionar Modelo" para salvar. Para definir como modelo padrão, ative o switch "Definir como Modelo Padrão" na parte inferior. + +### Opção 2: Editar Arquivo de Configuração + +Adicione ao model_list no config.json (sem chaves): + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "deepseek", + "model": "deepseek/deepseek-chat" + } + ], + "agents": { + "defaults": { + "model_name": "deepseek" + } + } +} +``` + +Armazene chaves em ~/.picoclaw/.security.yml: + +```yaml +model_list: + deepseek:0: + api_keys: + - "sk-your-deepseek-key" +``` + +O prefixo do protocolo deepseek tem endpoint padrão integrado https://api.deepseek.com/v1, não é necessário preencher api_base + +## Notas + +- DeepSeek atualmente suporta apenas pay-as-you-go, sem planos de assinatura +- deepseek-chat atualmente corresponde ao DeepSeek-V3.2 +- Para produção, armazene a Chave da API em .security.yml, evite texto simples no config.json \ No newline at end of file diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/minimax.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/minimax.md new file mode 100644 index 0000000..b9b0168 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/minimax.md @@ -0,0 +1,101 @@ +--- +id: minimax-api +title: MiniMax API +--- + +# Guia de Configuração do MiniMax + +## Visão Geral + +**MiniMax** é uma empresa líder em grandes modelos multimodais na China. A série MiniMax-M2 se destaca na compreensão de contexto longo, processamento multimodal e capacidades de raciocínio. + +O Plano de Token do MiniMax fornece cotas de solicitação de alta frequência por meio de assinaturas, e os planos de edição de velocidade fornecem garantias de throughput suficientes para cenários de alta concorrência, tornando-o uma excelente escolha para desenvolvedores que buscam estabilidade e velocidade. + +![Visão Geral do MiniMax](/img/providers/minimax-overview.png) + +Documentação Oficial: https://platform.minimaxi.com/docs/token-plan/intro + +## Obtendo Chave da API + +O MiniMax oferece **pacotes de assinatura do Plano de Token** e **pay-as-you-go**, ambos usando o mesmo endpoint, mas Chaves da API diferentes. Obtenha da página correspondente. + +### Chave Exclusiva do Plano de Token + +1. Visite [Plataforma Open do MiniMax](https://platform.minimaxi.com/), registre-se e faça login +2. Vá para [Página de Assinatura](https://platform.minimaxi.com/subscribe/token-plan) para assinar um plano +3. Obtenha Chave da API exclusiva na página de gerenciamento do plano + +### Chave Pay-as-you-go + +1. Visite [Plataforma Open do MiniMax](https://platform.minimaxi.com/), registre-se e faça login +2. Crie Chave da API na página API Keys do console + + *⚠️ **Nota**: A Chave da API é mostrada apenas uma vez, salve imediatamente.* + +### Uso do Plano de Token (solicitações M2.7 apenas) + +| Plano | Solicitações por 5 horas | +|-------|---------------------------| +| Starter | 600 chamadas | +| Plus | 1.500 chamadas | +| Max | 4.500 chamadas | +| Plus-Speed | 1.500 chamadas (M2.7-highspeed) | +| Max-Speed | 4.500 chamadas (M2.7-highspeed) | +| Ultra-Speed | 30.000 chamadas (M2.7-highspeed) | + +Os planos de edição de velocidade podem usar o modelo MiniMax-M2.7-highspeed, velocidade mais rápida. + +## Configurando PicoClaw + +### Opção 1: Usando WebUI (Recomendado) + +Abra o WebUI do PicoClaw, vá para a página **Models** na navegação esquerda, clique em "Adicionar Modelo" no canto superior direito: + +![Adicionar Modelo](/img/providers/webuimodel.png) + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., minimax | +| Identificador do Modelo | minimax/MiniMax-M2.7 (use minimax/MiniMax-M2.7-highspeed para edição de velocidade) | +| Chave da API | Sua Chave da API do MiniMax | +| URL Base da API | Deixe vazio (usa automaticamente o endpoint padrão) | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "minimax", + "model": "minimax/MiniMax-M2.7" + } + ], + "agents": { + "defaults": { + "model_name": "minimax" + } + } +} +``` + +*Para edição de velocidade, mude o modelo para minimax/MiniMax-M2.7-highspeed* + +~/.picoclaw/.security.yml: + +```yaml +model_list: + minimax:0: + api_keys: + - "your-minimax-api-key" +``` + +O prefixo do protocolo minimax tem endpoint padrão integrado https://api.minimaxi.com/v1, não é necessário preencher api_base + +## Notas + +- Plano de Token e pay-as-you-go usam o mesmo endpoint, mas as Chaves da API são diferentes, obtenha da página correspondente +- O modelo de edição de velocidade MiniMax-M2.7-highspeed está disponível apenas quando assinado aos planos de edição de velocidade +- Para produção, armazene a Chave da API em .security.yml, evite texto simples no config.json \ No newline at end of file diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/moonshot.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/moonshot.md new file mode 100644 index 0000000..154cb9e --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/moonshot.md @@ -0,0 +1,93 @@ +--- +id: moonshot-api +title: Moonshot (Kimi) API +--- + +# Guia de Configuração do Moonshot (Kimi) + +## Visão Geral + +**Kimi** (Moonshot) é uma das startups de grandes modelos mais observadas na China, começando com capacidades de processamento de contexto ultra-longo. A série Kimi-K2 alcançou avanços significativos na geração de código e raciocínio complexo, classificando-se entre os melhores modelos da China. + +A Plataforma Open do Kimi fornece interfaces padrão compatíveis com OpenAI com integração simples, tornando-a uma excelente escolha para desenvolvedores que desejam experimentar as melhores capacidades de inferência da China. + +![Visão Geral do Kimi](/img/providers/kimi-overview.png) + +Documentação Oficial: https://platform.kimi.com/docs/api/chat + +***Nota**: A associação Kimi Code restringe explicitamente o uso apenas no Claude Code e Roo Code* + +*Usar a Chave da API de associação no PicoClaw carrega risco de banimento da conta* + +*Este artigo apresenta apenas a API pay-as-you-go da platform.kimi.com* + +## Obtendo Chave da API + +### Passo 1: Visitar Plataforma + +Acesse [Plataforma Open do Kimi](https://platform.kimi.com/), registre-se e faça login. + +### Passo 2: Criar Chave da API + +1. Entre no Console → página **API Keys** +2. Crie Chave da API, copie e salve com segurança + + *⚠️ **Nota**: A Chave da API é mostrada apenas uma vez, salve imediatamente.* + +### Modelos e Preços + +| Modelo | Entrada (Cache Hit) | Entrada (Cache Miss) | Saída | Comprimento do Contexto | +|--------|---------------------|-----------------------|-------|-------------------------| +| kimi-k2.5 | ¥0.70/M tokens | ¥4.00/M tokens | ¥21.00/M tokens | 262.144 tokens | + +## Configurando PicoClaw + +### Opção 1: Usando WebUI (Recomendado) + +Abra o WebUI do PicoClaw, vá para a página **Models** na navegação esquerda, clique em "Adicionar Modelo" no canto superior direito: + +![Adicionar Modelo](/img/providers/webuimodel.png) + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., kimi | +| Identificador do Modelo | moonshot/kimi-k2.5 | +| Chave da API | Sua Chave da API do Kimi | +| URL Base da API | Deixe vazio (usa automaticamente o endpoint padrão) | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "kimi", + "model": "moonshot/kimi-k2.5" + } + ], + "agents": { + "defaults": { + "model_name": "kimi" + } + } +} +``` + +~/.picoclaw/.security.yml: + +```yaml +model_list: + kimi:0: + api_keys: + - "your-kimi-api-key" +``` + +O prefixo do protocolo moonshot tem endpoint padrão integrado https://api.moonshot.cn/v1, não é necessário preencher api_base + +## Notas + +- Não use a Chave da API de associação Kimi Code, use apenas a Chave da API pay-as-you-go da platform.kimi.com +- Para produção, armazene a Chave da API em .security.yml, evite texto simples no config.json \ No newline at end of file diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/qwen.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/qwen.md new file mode 100644 index 0000000..cb058d2 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/qwen.md @@ -0,0 +1,154 @@ +--- +id: qwen-api +title: Alibaba Bailian (Qwen) API +--- + +# Guia de Configuração do Alibaba Bailian (Qwen) + +## Visão Geral + +**Alibaba Bailian** é a plataforma de serviço de grandes modelos da Alibaba Cloud, confiando na poderosa infraestrutura da Alibaba Cloud para fornecer serviços de inferência estáveis e de baixa latência. + +Os modelos da série Tongyi Qianwen (Qwen) continuam liderando nas direções de código, multilíngue e contexto longo. Qwen3.5-Plus classificou-se entre os melhores em vários benchmarks globais. + +O Plano de Codificação Bailian é um pacote de assinatura que agrupa vários modelos de topo, tornando-o um dos pacotes de programação AI mais econômicos para desenvolvedores domésticos. + +Documentação Oficial: https://help.aliyun.com/zh/model-studio/coding-plan + +![Plano de Codificação Alibaba Bailian](/img/providers/qwen-coding-plan.png) + +## Obtendo Chave da API + +O Alibaba Bailian oferece dois métodos de uso: **pacote de assinatura do Plano de Codificação** (recomendado) e **pay-as-you-go**. + +Eles usam endpoints e Chaves da API diferentes, por favor, distingua entre eles. + +### Chave Exclusiva do Plano de Codificação + +1. Visite [Página do Plano de Codificação Alibaba Bailian](https://bailian.console.aliyun.com/coding-plan) + +2. Após assinar o plano, obtenha a **Chave da API Exclusiva do Plano de Codificação** (formato: sk-sp-xxxxx) na página. + + *⚠️ A Chave Exclusiva do Plano de Codificação é diferente da Chave da API Bailian comum. Obtenha separadamente na página do Plano de Codificação.* + +### Chave Pay-as-you-go + +1. Visite [Console Alibaba Bailian](https://bailian.console.aliyun.com/) + + ![Console Alibaba Bailian](/img/providers/qwen-console.png) + +2. Crie uma Chave da API comum na página de gerenciamento de Chave da API. + +## Configurando PicoClaw + +### Plano de Codificação (Recomendado) + +O Plano de Codificação suporta vários modelos mainstream como qwen3.5-plus, kimi-k2.5, glm-5, MiniMax-M2.5. + +### Modelos Suportados + +| Modelo | Descrição | +|--------|-----------| +| qwen3.5-plus | Recomendado, suporta compreensão de imagem | +| kimi-k2.5 | Recomendado, suporta compreensão de imagem | +| glm-5 | Recomendado | +| MiniMax-M2.5 | Recomendado | +| qwen3-max-2026-01-23 | Mais opções | +| qwen3-coder-next | Mais opções | +| qwen3-coder-plus | Mais opções | +| glm-4.7 | Mais opções | + +### Opção 1: Usando WebUI (Recomendado) + +Abra o WebUI do PicoClaw, vá para a página **Models** na navegação esquerda, clique em "Adicionar Modelo" no canto superior direito: + +![Adicionar Modelo](/img/providers/webuimodel.png) + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., qwen-coding | +| Identificador do Modelo | openai/qwen3.5-plus (ou outros modelos suportados) | +| Chave da API | Chave da API Exclusiva do Plano de Codificação (sk-sp-xxxxx) | +| URL Base da API | https://coding.dashscope.aliyuncs.com/v1 | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "qwen-coding", + "model": "openai/qwen3.5-plus", + "api_base": "https://coding.dashscope.aliyuncs.com/v1" + } + ], + "agents": { + "defaults": { + "model_name": "qwen-coding" + } + } +} +``` + +~/.picoclaw/.security.yml: + +```yaml +model_list: + qwen-coding:0: + api_keys: + - "sk-sp-your-coding-plan-key" +``` + +### Pay-as-you-go + +### Opção 1: Usando WebUI + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., qwen | +| Identificador do Modelo | qwen/qwen3.5-plus (ou outros modelos) | +| Chave da API | Chave da API Bailian comum | +| URL Base da API | Deixe vazio (usa automaticamente o endpoint padrão) | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "qwen", + "model": "qwen/qwen3.5-plus" + } + ], + "agents": { + "defaults": { + "model_name": "qwen" + } + } +} +``` + +~/.picoclaw/.security.yml: + +```yaml +model_list: + qwen:0: + api_keys: + - "your-ordinary-bailian-api-key" +``` + +## Limites e Cotas + +### Cobrança + +O Plano de Codificação usa um modelo de assinatura, enquanto pay-as-you-go cobra com base no uso real. + +### Limites de Taxa + +Planos diferentes têm limites de taxa diferentes. Consulte a documentação oficial para detalhes. \ No newline at end of file diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/volcengine.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/volcengine.md new file mode 100644 index 0000000..b45f687 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/volcengine.md @@ -0,0 +1,149 @@ +--- +id: volcengine-api +title: VolcEngine (Doubao) API +--- + +# Guia de Configuração do VolcEngine (Doubao) + +## Visão Geral + +**VolcEngine** é a plataforma de serviço em nuvem da ByteDance. A série de grandes modelos Doubao se destaca na velocidade de resposta e estabilidade de concorrência graças à profunda expertise da ByteDance em sistemas de recomendação e engenharia em grande escala. + +A Plataforma Ark do VolcEngine agrega modelos de topo de Doubao, MiniMax, Kimi, GLM, DeepSeek, etc., através do Plano de Codificação, fornecendo aos desenvolvedores grande conveniência por meio de interfaces unificadas e preços de assinatura. É um dos pacotes de agregação de modelos mais abrangentes da China. + +![Plataforma Ark do VolcEngine](/img/providers/volcengine-ark.png) + +Documentação Oficial: https://www.volcengine.com/docs/82379/1928262?lang=zh + +## Obtendo Chave da API + +### Passo 1: Visitar Plataforma + +Acesse [Console Ark do VolcEngine](https://console.volcengine.com/ark), registre-se e faça login. + +### Passo 2: Assinar Plano e Obter Chave + +1. Assine o Plano de Codificação (ou pay-as-you-go) +2. Crie e copie a Chave da API na página de gerenciamento de Chave da API do console. + +## Configurando PicoClaw + +### Plano de Codificação (Recomendado) + +### Uso do Plano + +| Plano | Por 5 Horas | Semanal | Por Mês de Assinatura | +|-------|-------------|---------|-----------------------| +| Lite | ~1.200 chamadas | ~9.000 chamadas | ~18.000 chamadas | +| Pro | ~6.000 chamadas | ~45.000 chamadas | ~90.000 chamadas | + +### Modelos Suportados + +| Modelo | Descrição | +|--------|-----------| +| Doubao-Seed-2.0-pro | Bandeira Doubao | +| Doubao-Seed-2.0-lite | Leve Doubao | +| Doubao-Seed-2.0-Code | Especializado em código Doubao | +| Doubao-Seed-Code | Código Doubao | +| MiniMax-M2.5 | MiniMax | +| Kimi-K2.5 | Kimi | +| GLM-4.7 | Zhipu GLM | +| DeepSeek-V3.2 | DeepSeek | +| ark-code-latest | Selecionar automaticamente o modelo ótimo | + +*Ao usar ark-code-latest, você pode alternar modelos alvo na página de gerenciamento do VolcEngine ou habilitar o modo Auto para seleção automática do sistema. As mudanças entram em vigor em 3-5 minutos.* + +### Opção 1: Usando WebUI (Recomendado) + +Abra o WebUI do PicoClaw, vá para a página **Models** na navegação esquerda, clique em "Adicionar Modelo" no canto superior direito: + +![Adicionar Modelo](/img/providers/webuimodel.png) + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., volcengine | +| Identificador do Modelo | volcengine/Doubao-Seed-2.0-pro (ou outros modelos suportados) | +| Chave da API | Chave da API do VolcEngine | +| URL Base da API | https://ark.cn-beijing.volces.com/api/coding/v3 | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "volcengine", + "model": "volcengine/Doubao-Seed-2.0-pro", + "api_base": "https://ark.cn-beijing.volces.com/api/coding/v3" + } + ], + "agents": { + "defaults": { + "model_name": "volcengine" + } + } +} +``` + +*Se usar roteamento automático ark-code-latest, mude o modelo para volcengine/ark-code-latest* + +~/.picoclaw/.security.yml: + +```yaml +model_list: + volcengine:0: + api_keys: + - "your-volcengine-api-key" +``` + +### Pay-as-you-go + +### Opção 1: Usando WebUI + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., volcengine | +| Identificador do Modelo | volcengine/Doubao-Seed-2.0-pro (ou outros modelos) | +| Chave da API | Chave da API do VolcEngine | +| URL Base da API | Deixe vazio (usa automaticamente o endpoint padrão) | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "volcengine", + "model": "volcengine/Doubao-Seed-2.0-pro" + } + ], + "agents": { + "defaults": { + "model_name": "volcengine" + } + } +} +``` + +~/.picoclaw/.security.yml: + +```yaml +model_list: + volcengine:0: + api_keys: + - "your-volcengine-api-key" +``` + +O prefixo do protocolo volcengine tem endpoint padrão integrado https://ark.cn-beijing.volces.com/api/v3, não é necessário preencher api_base + +## Notas + +- O endpoint do Plano de Codificação é https://ark.cn-beijing.volces.com/api/coding/v3, o endpoint pay-as-you-go é https://ark.cn-beijing.volces.com/api/v3, eles são diferentes, não preencha errado +- Pay-as-you-go deduz diretamente do saldo da conta, recomende usar Plano de Codificação primeiro +- Para produção, armazene a Chave da API em .security.yml, evite texto simples no config.json \ No newline at end of file diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/zhipu.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/zhipu.md new file mode 100644 index 0000000..835520f --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/providers/zhipu.md @@ -0,0 +1,147 @@ +--- +id: zhipu-api +title: Zhipu AI (GLM) API +--- + +# Guia de Configuração do Zhipu AI (GLM) + +## Visão Geral + +**Zhipu AI** é uma força importante no campo de grandes modelos da China, confiando no profundo background acadêmico da Universidade Tsinghua. Os modelos da série GLM continuam avançando na compreensão chinesa, geração de código e raciocínio complexo. + +GLM-4.7 tornou-se uma escolha confiável para tarefas diárias de programação com desempenho equilibrado e alta custo-efetividade, enquanto a série GLM-5 compara-se aos melhores modelos internacionais em tarefas complexas. + +O Plano de Codificação Zhipu fornece aos desenvolvedores cotas de assinatura estáveis e é uma parte importante do ecossistema de programação AI da China. + +![Plano de Codificação Zhipu](/img/providers/zhipu-coding-plan.png) + +Documentação Oficial: https://docs.bigmodel.cn/cn/coding-plan/tool/openclaw + +## Obtendo Chave da API + +### Passo 1: Visitar Plataforma + +Acesse [Plataforma Open do Zhipu AI](https://open.bigmodel.cn/), registre-se e faça login. + +### Passo 2: Criar Chave da API + +1. Assine o Plano de Codificação (ou pay-as-you-go) +2. Crie e copie a Chave da API na página de gerenciamento de Chave da API do console. + + *⚠️ **Nota**: A Chave da API é mostrada apenas uma vez, salve imediatamente.* + +## Configurando PicoClaw + +### Plano de Codificação (Recomendado) + +### Modelos Suportados + +| Modelo | Descrição | +|--------|-----------| +| GLM-4.7 | Recomendado para a maioria das tarefas, uso de cota mais econômico | +| GLM-5.1 | Modelo de alta ponta, comparável ao Claude Opus. Consome 3x cota durante pico, 2x durante fora do pico | +| GLM-5 | Modelo de alta ponta, mesmo coeficiente de consumo que GLM-5.1 | +| GLM-5-Turbo | Modelo de alta ponta, mesmo coeficiente de consumo que GLM-5.1 | +| GLM-4.6 | Mais opções | +| GLM-4.5 | Mais opções | +| GLM-4.5-Air | Mais opções | +| GLM-4.5V | Mais opções | +| GLM-4.6V | Mais opções | + +*Recomende usar GLM-4.7 primeiro, mude para GLM-5.1 apenas para tarefas particularmente complexas para evitar consumir cota muito rapidamente.* + +*Não selecione modelos Flash, FlashX, etc., caso contrário, o saldo da conta será deduzido.* + +### Opção 1: Usando WebUI (Recomendado) + +Abra o WebUI do PicoClaw, vá para a página **Models** na navegação esquerda, clique em "Adicionar Modelo" no canto superior direito: + +![Adicionar Modelo](/img/providers/webuimodel.png) + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., glm | +| Identificador do Modelo | zhipu/GLM-4.7 (ou outros modelos suportados) | +| Chave da API | Sua Chave da API do Zhipu | +| URL Base da API | https://open.bigmodel.cn/api/coding/paas/v4 | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "glm", + "model": "zhipu/GLM-4.7", + "api_base": "https://open.bigmodel.cn/api/coding/paas/v4" + } + ], + "agents": { + "defaults": { + "model_name": "glm" + } + } +} +``` + +~/.picoclaw/.security.yml: + +```yaml +model_list: + glm:0: + api_keys: + - "your-zhipu-api-key" +``` + +### Pay-as-you-go + +### Opção 1: Usando WebUI + +| Campo | Valor | +|-------|-------| +| Alias do Modelo | Nome personalizado, ex., glm | +| Identificador do Modelo | zhipu/GLM-4.7 | +| Chave da API | Sua Chave da API do Zhipu | +| URL Base da API | Deixe vazio (usa automaticamente o endpoint padrão) | + +### Opção 2: Editar Arquivo de Configuração + +config.json: + +```json +{ + "version": 2, + "model_list": [ + { + "model_name": "glm", + "model": "zhipu/GLM-4.7" + } + ], + "agents": { + "defaults": { + "model_name": "glm" + } + } +} +``` + +~/.picoclaw/.security.yml: + +```yaml +model_list: + glm:0: + api_keys: + - "your-zhipu-api-key" +``` + +O prefixo do protocolo zhipu tem endpoint padrão integrado https://open.bigmodel.cn/api/paas/v4, não é necessário preencher api_base + +## Notas + +- O endpoint do Plano de Codificação é https://open.bigmodel.cn/api/coding/paas/v4, o endpoint pay-as-you-go é https://open.bigmodel.cn/api/paas/v4, eles são diferentes, não preencha errado +- Pay-as-you-go deduz diretamente do saldo da conta, recomende usar Plano de Codificação primeiro +- GLM-5.1, GLM-5, GLM-5-Turbo consomem cota rapidamente, recomende GLM-4.7 para tarefas diárias +- Para produção, armazene a Chave da API em .security.yml, evite texto simples no config.json \ No newline at end of file