Pi
Load both DeepSeek preview IDs through one custom provider.
On this page
Current availabilityInstall PiPrepare your keySave models.jsonStart PiSwitch modelsChoose reasoning effortVerify your first requestTroubleshoot and restoreReferenceCurrent availability#
DSSUB is a design preview. These are complete configuration references, not a live connection: api.dssub.invalid is intentionally non-routable. No real account, key, payment or inference service is connected. Replace the endpoint and use an authorized key only after DSSUB publishes verified connection details. Client versions and live tool compatibility remain unverified.
Install Pi#
Follow the official installation instructions and record pi --version.
Prepare your key#
When a real endpoint is available, supply its authorized key in the same terminal that starts the tool. The following value is a placeholder.
macOS or Linux
export DSSUB_API_KEY="YOUR_DSSUB_API_KEY"Windows PowerShell
$env:DSSUB_API_KEY = "YOUR_DSSUB_API_KEY"Do not add a real key to a shared project or downloaded template. Desktop applications may not inherit terminal environment variables; use their supported credential setup.
Save models.json#
Merge this provider into models.json in the active Pi agent directory, commonly ~/.pi/agent; check your installed version and any PI_CODING_AGENT_DIR override. Preserve existing providers.
{
"$schema": "https://pi.dev/schemas/models.schema.json",
"providers": {
"dssub": {
"baseUrl": "https://api.dssub.invalid/v1",
"api": "openai-completions",
"apiKey": "$DSSUB_API_KEY",
"models": [
{
"id": "deepseek-flash",
"name": "DeepSeek V4.1 Flash"
},
{
"id": "deepseek-v4-pro",
"name": "DeepSeek V4 Pro"
}
]
}
}
}The leading dollar sign in $DSSUB_API_KEY requests environment interpolation in the current Pi format. It is not a literal API key.
Start Pi#
pi --provider dssub --model deepseek-flashSwitch models#
Open /model and choose the other DSSUB model. This also reloads the model file in current Pi versions. Starting with --model deepseek-v4-pro changes the model for a new run.
Choose reasoning effort#
Pi’s /thinking lists levels supported by the selected model. This template does not declare verified DSSUB reasoning capabilities. Leave the default until the exact route is tested; do not add unsupported levels just to expose controls.
Verify your first request#
After a live connection is published, start a new session in a small test project. First ask for a short text reply. Then ask the tool to read README.md and summarize it without modifying files. Confirm the selected provider and model, then match the request in Usage. Check tool results, streaming completion and billed tokens separately. The current sample dashboard cannot verify a real request.
Troubleshoot and restore#
A DNS failure for api.dssub.invalid is expected in this preview. For a real connection, check the exact endpoint, API format, model ID and credential. A 401 concerns authentication; a 404 may concern a path or model; a 429 may concern a quota or rate limit. See troubleshooting.
Back up configuration before editing, merge only DSSUB fields, and retain your existing providers and permissions. To revert, select your previous provider and restore only the fields you changed. Stop and restart the tool after changing its startup environment.
Reference#
Pi model configuration, reviewed November 16, 2026.
Guide updated November 11, 2026 · All tutorials