Connect with Pi

​

Before you begin

• A Modular Cloud account.
• A Modular Cloud API key.
• Pi installed.

​

Configure a Pi provider

1. Open (or create) the ~/.pi/agent/models.json configuration file.
2. Choose the model that you want from our list of shared endpoints or use a dedicated deployment if applicable.
3. Add Modular Cloud as a provider:
   models.json

   {
     "providers": {
       "modular": {
         "baseUrl": "https://api.modular.com/v1",
         "api": "openai-completions",
         "apiKey": "$MODULAR_API_KEY",
         "models": [
           {
             "id": "minimax/minimax-m3",
             "name": "MiniMax M3"
           }
         ]
       }
     }
   }
   
   Modular Cloud supports the OpenAI chat completions API, so set api to openai-completions. Modular Cloud doesn’t support the OpenAI responses API.

​

Retry rate-limited requests

{
  "retry": {
    "provider": {
      "maxRetries": 10,
      "maxRetryDelayMs": 600000
    }
  }
}

• maxRetries sets how many times Pi retries a failed request from the model provider before it stops trying.
• maxRetryDelayMs sets the maximum server-requested delay in milliseconds. The default is 60000 (1 minute).