Configuração do Pi

Uma conexão. Todos os sete modelos.

Configure seu agente uma vez e troque de modelo e esforço de raciocínio na mesma sessão.

Baixar ZIP de configuração com todos os modelos ↗

InterfaceSistema operacional

Prefere pular a configuração manual? Peça à IA para fazer isso por você.

Prompt de configuração com IA

Siga https://siapi.ai/pt-br/docs/pi?model=deepseek-flash&surface=cli&platform=macos para conectar meu Agent a todos os modelos SI-API. Preserve as configurações existentes e peça minha chave de API quando necessário.

GLM 5.3 Flash
DeepSeek V4.1 Flash
Kimi K3.1 Pro
Kimi K3.1 Pro HighSpeed
GLM 5.3
MiniMax M3.1 Flash
Qwen3.8 Max

Os sete modelos estão neste download. Mantenha a mesma configuração ao trocar de modelo. Obter sua chave de API →

1. Prepare sua ferramenta e sua chave

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

Guia oficial de instalação ↗

Prepare sua ferramenta e sua chave

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

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.

Ver ou copiar configuração

models.json

Baixar

{
  "providers": {
    "siapi": {
      "baseUrl": "https://siapi.ai/v1",
      "api": "openai-completions",
      "apiKey": "$SIAPI_API_KEY",
      "models": [
        {
          "id": "glm-5.3-flash",
          "name": "GLM 5.3 Flash",
          "input": [
            "text"
          ],
          "reasoning": true,
          "thinkingLevelMap": {
            "off": null,
            "minimal": null,
            "low": "low",
            "medium": null,
            "high": "high",
            "xhigh": null,
            "max": "max"
          },
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": true
          }
        },
        {
          "id": "deepseek-flash",
          "name": "DeepSeek V4.1 Flash",
          "input": [
            "text"
          ],
          "reasoning": true,
          "thinkingLevelMap": {
            "off": "none",
            "minimal": null,
            "low": "low",
            "medium": null,
            "high": "high",
            "xhigh": null,
            "max": "max"
          },
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": true
          }
        },
        {
          "id": "kimi-k3.1-pro",
          "name": "Kimi K3.1 Pro",
          "input": [
            "text"
          ],
          "reasoning": true,
          "thinkingLevelMap": {
            "off": null,
            "minimal": null,
            "low": "low",
            "medium": null,
            "high": "high",
            "xhigh": null,
            "max": "max"
          },
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": true
          }
        },
        {
          "id": "kimi-k3.1-pro-highspeed",
          "name": "Kimi K3.1 Pro HighSpeed",
          "input": [
            "text"
          ],
          "reasoning": true,
          "thinkingLevelMap": {
            "off": null,
            "minimal": null,
            "low": "low",
            "medium": null,
            "high": "high",
            "xhigh": null,
            "max": "max"
          },
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": true
          }
        },
        {
          "id": "glm-5.3",
          "name": "GLM 5.3",
          "input": [
            "text"
          ],
          "reasoning": true,
          "thinkingLevelMap": {
            "off": null,
            "minimal": null,
            "low": "low",
            "medium": null,
            "high": "high",
            "xhigh": null,
            "max": "max"
          },
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": true
          }
        },
        {
          "id": "minimax-m3.1",
          "name": "MiniMax M3.1 Flash",
          "input": [
            "text"
          ],
          "reasoning": false,
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": false
          }
        },
        {
          "id": "qwen3.8-max",
          "name": "Qwen3.8 Max",
          "input": [
            "text"
          ],
          "reasoning": true,
          "thinkingLevelMap": {
            "off": "none",
            "minimal": null,
            "low": "low",
            "medium": "medium",
            "high": null,
            "xhigh": "xhigh",
            "max": null
          },
          "compat": {
            "supportsDeveloperRole": false,
            "supportsReasoningEffort": true
          }
        }
      ]
    }
  }
}

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.

Ver ou copiar configuração

settings.json

Baixar

{
  "defaultProvider": "siapi",
  "defaultModel": "deepseek-flash",
  "modelThinkingLevels": {
    "siapi/glm-5.3-flash": "max",
    "siapi/deepseek-flash": "high",
    "siapi/kimi-k3.1-pro": "max",
    "siapi/kimi-k3.1-pro-highspeed": "max",
    "siapi/glm-5.3": "max",
    "siapi/qwen3.8-max": "xhigh"
  }
}

3. Inicie seu agente

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

Inicie seu agente

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.

Todos os 7 modelos nesta configuração de agente
Modelo / ID na API	Comando / caminho no seletor	Configurações de raciocínio
GLM 5.3 Flash `glm-5.3-flash`	`/model → SI-API → GLM 5.3 Flash (glm-5.3-flash)`	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)`	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)`	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)`	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)`	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)`	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)`	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

/thinking

Os níveis de esforço disponíveis dependem do modelo; consulte a tabela acima. O MiniMax M3.1 Flash usa o padrão do modelo.

Padrões de esforço e configurações salvas

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

/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 ↗

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.

Na sua ferramenta

/model
/thinking

Envie esta tarefa na sua ferramenta

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.

Observações sobre a ferramenta

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.

Referência oficial de configuração ↗ · Configuração do modelo

A conexão não funciona? · Uso

Compatibilidade dos Agents — Versões dos clientes, campos de raciocínio testados e limitações conhecidas.

Baixar instruções de configuração