# Pi · SI-API

Todos os 7 modelos da SI-API · uma configuração de agente
Modelo inicial padrão: deepseek-flash
Interface: cli
Sistema: macos

Modelos incluídos: GLM 5.3 Flash (glm-5.3-flash), DeepSeek V4.1 Flash (deepseek-flash), Kimi K3.1 Pro (kimi-k3.1-pro), Kimi K3.1 Pro HighSpeed (kimi-k3.1-pro-highspeed), GLM 5.3 (glm-5.3), MiniMax M3.1 Flash (minimax-m3.1), Qwen3.8 Max (qwen3.8-max).

Os modelos de configuração contêm apenas marcadores. Salve sua chave real localmente. Preserve configurações e permissões não relacionadas.

## 1. Prepare sua ferramenta e sua chave

Instale Pi pela página oficial. Crie ou copie sua chave SI-API em /pt-br/keys.

export SIAPI_API_KEY="YOUR_SIAPI_API_KEY"



## 2. Salve a configuração

Baixe e extraia o ZIP. Substitua YOUR_SIAPI_API_KEY pela sua chave e salve cada arquivo no caminho indicado abaixo. Mescle os campos com o arquivo existente, preservando outros provedores, permissões e preferências. Não substitua toda a configuração existente.

Local da configuração: ~/.config/siapi/pi



## 3. Inicie seu agente

Inicie uma nova sessão e envie uma mensagem. O modelo inicial é deepseek-flash.

PI_CODING_AGENT_DIR="$HOME/.config/siapi/pi" pi --provider siapi --model deepseek-flash



## 4. Alterne entre todos os modelos

Após a configuração, escolha qualquer modelo abaixo dentro do agente. A mesma chave e configuração funcionam com os sete modelos; não é necessário baixar ou conectar novamente.





### GLM 5.3 Flash · glm-5.3-flash

/model → SI-API → GLM 5.3 Flash (glm-5.3-flash)

Configurações de raciocínio: Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.

### DeepSeek V4.1 Flash · deepseek-flash

/model → SI-API → DeepSeek V4.1 Flash (deepseek-flash)

Configurações de raciocínio: Off, Low, High e Max. Medium / XHigh correspondem a High; Ultra corresponde a Max.

### Kimi K3.1 Pro · kimi-k3.1-pro

/model → SI-API → Kimi K3.1 Pro (kimi-k3.1-pro)

Configurações de raciocínio: Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.

### Kimi K3.1 Pro HighSpeed · kimi-k3.1-pro-highspeed

/model → SI-API → Kimi K3.1 Pro HighSpeed (kimi-k3.1-pro-highspeed)

Configurações de raciocínio: Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.

### GLM 5.3 · glm-5.3

/model → SI-API → GLM 5.3 (glm-5.3)

Configurações de raciocínio: Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.

### MiniMax M3.1 Flash · minimax-m3.1

/model → SI-API → MiniMax M3.1 Flash (minimax-m3.1)

Configurações de raciocínio: Use o padrão do modelo. Esta rota não oferece controles personalizados de raciocínio.

### Qwen3.8 Max · qwen3.8-max

/model → SI-API → Qwen3.8 Max (qwen3.8-max)

Configurações de raciocínio: Off, Low, Medium e XHigh. High / Max correspondem a XHigh, sem níveis adicionais.

## 5. Escolha o esforço de raciocínio



Envie cada comando separadamente dentro do agente. Com DeepSeek V4.1 Flash, alterne de Low para High antes da próxima mensagem.

### Dentro do agente

```text

/thinking

```





Comece com o DeepSeek V4.1 Flash. Escolha Low, envie uma tarefa curta de leitura de arquivo, depois escolha High e repita. Confira a configuração atual após cada alteração.

Effort é a quantidade de raciocínio solicitada. Kimi K3.1 Pro / HighSpeed, GLM 5.3 e GLM 5.3 Flash oferecem Low / High / Max, com raciocínio sempre ativado. Escolha Low para raciocínio mais curto; não há opção Off. O padrão desses modelos é Max, mas o cliente pode substituí-lo. DeepSeek e Qwen têm os níveis próprios listados abaixo.

O MiniMax M3.1 Flash usa o raciocínio padrão. As configurações do MiniMax M3 se aplicam a outro modelo.

Salve os dois arquivos fornecidos. settings.json usa modelThinkingLevels para definir High em DeepSeek, Max em Kimi e GLM e XHigh em Qwen. models.json declara as opções disponíveis, mas não define esses padrões.

Abra /thinking e escolha Low ou High, ou use Shift+Tab para alternar entre os níveis aceitos. O rodapé mostra o nível ativo. Isso muda a sessão; Ctrl+S salva o padrão global alternativo. Padrões por modelo têm prioridade: edite modelThinkingLevels ou use /settings → Default thinking level per model. Ctrl+T apenas mostra ou oculta o texto de raciocínio.

### No agente · envie cada comando separadamente

```text

/model
/thinking

```

- Se o seletor não aparecer, confirme que o Pi carregou o models.json fornecido do mesmo PI_CODING_AGENT_DIR. Modelos compatíveis precisam de reasoning: true e thinkingLevelMap completo. Entradas null removem níveis não aceitos; não as exclua. Abra /model para recarregar e confira /thinking novamente.

Resultado esperado: No DeepSeek V4.1 Flash, a configuração muda de Low para High e volta a Low antes da próxima mensagem. Os demais modelos seguem os controles abaixo.

Recursos personalizados de raciocínio do Pi: https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md

## 6. Confira o modelo e execute sua primeira tarefa

Abra um projeto com README.md. Permita que a ferramenta leia o arquivo e envie o prompt abaixo. Confirme a leitura e o retorno de um resumo. Para testar outro modelo, troque pela tabela acima e repita a tarefa.

/model
/thinking

Use a ferramenta de leitura de arquivos para ler o README.md deste projeto e resumir sua finalidade em uma frase. Não modifique nenhum arquivo.

## models.json

Salvar em: ~/.config/siapi/pi/models.json

Salve na pasta dedicada do Pi. Preserve os campos reasoning, thinkingLevelMap e compat, incluindo entradas null que desabilitam níveis não aceitos. Salve settings.json ao lado para os padrões de esforço por modelo. Preserve os provedores existentes se o arquivo já existir.

## settings.json

Salvar em: ~/.config/siapi/pi/settings.json

Mescle estes campos no arquivo existente, preservando outros provedores, permissões e preferências. Não substitua a configuração inteira. modelThinkingLevels define o esforço inicial de cada modelo; models.json declara separadamente as opções disponíveis. Salve os dois arquivos no mesmo PI_CODING_AGENT_DIR.

## Observações

O Pi funciona no terminal, incluindo o terminal integrado de um editor. Não há configuração separada de aplicativo de desktop aqui.

Abrir /model recarrega models.json. Use /thinking para a sessão; settings.json guarda os padrões iniciais. Níveis de raciocínio não aceitos são desabilitados no mapeamento do modelo.

Off, Low, High e Max. Medium / XHigh correspondem a High; Ultra corresponde a Max.

Referência: https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md

Configuração dos modelos: https://siapi.ai/pt-br/docs/models#configuration

Compatibilidade dos Agents: https://siapi.ai/pt-br/docs/compatibility
