pi-byteplus-modelark

Pi coding agent extension that registers BytePlus ModelArk as a custom OpenAI-compatible provider, unlocking access to all supported coding models directly within the pi TUI.

One API key covers all models. No need to configure per-model keys.

Key Features

• Seamless ModelArk Integration: Adds BytePlus ModelArk as a first-class provider in pi's model registry
• OpenAI Compatibility: Works with pi's existing OpenAI-style tooling and prompts
• Multi-Model Support: Access all BytePlus ModelArk coding models (DeepSeek, GLM, Kimi, Seed, and more)
• Single API Key: One Coding Plan API key works across all models — no per-model configuration needed

Installation

pi install npm:pi-byteplus-modelark

Setup

You need a BytePlus ModelArk API key. Create one at https://console.byteplus.com.

Set the BYTEPLUS_API_KEY environment variable:

export BYTEPLUS_API_KEY="ark-your-api-key-here"

Add it to your ~/.bashrc or ~/.zshrc to persist across sessions.

Usage

Start pi and pick a model interactively (Recommended)

pi

Then use /model to select a BytePlus model from the list.

Note: Some BytePlus model IDs (like glm-5.1, kimi-k2.5) also exist in other built-in providers (opencode, zai). To avoid confusion, we recommend using /model to select models interactively.

Specify a model directly

# Auto-routed model (recommended)
pi --model ark-code-latest

# Use full provider/model syntax for models with ID collisions
pi --model byteplus/glm-5.1
pi --model byteplus/kimi-k2.5

# Models without collisions work directly
pi --model dola-seed-2.0-pro
pi --model deepseek-v3.2

Available Models

| Model ID | Name | Context | Max Output | |----------|------|---------|------------| | ark-code-latest | ModelArk Auto (recommended) | 128K | 8.2K | | dola-seed-2.0-pro | Seed 2.0 Pro | 262K | 128K | | dola-seed-2.0-lite | Seed 2.0 Lite | 262K | 128K | | dola-seed-2.0-code | Seed 2.0 Code | 262K | 128K | | bytedance-seed-code | ByteDance Seed Code | 128K | 8.2K | | glm-5.1 | GLM 5.1 | 204K | 65.5K | | glm-4.7 | GLM 4.7 | 204K | 65.5K | | kimi-k2.5 | Kimi K2.5 | 262K | 65.5K | | gpt-oss-120b | GPT-OSS 120B | 128K | 8.2K | | deepseek-v3.2 | DeepSeek V3.2 | 131K | 8.2K |

List all available models at any time:

pi --list-models

Important Notes

• Use the Coding Plan endpoint: This extension uses https://ark.ap-southeast.bytepluses.com/api/coding/v3 (Coding Plan URL). Do NOT switch to the base model URL (/api/v3) — that will incur additional charges outside your Coding Plan quota.
• API Key: Create your API key at BytePlus Console.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit changes with SemVer-compliant messages
4. Push to the branch (git push origin feature/your-feature)
5. Open a pull request

Support

• Open an issue: GitHub Issues

License

This project is licensed under the MIT License - see the LICENSE file for details.