​
Volcengine (Doubao)

The Volcengine provider gives access to Doubao models and third-party models hosted on Volcano Engine, with separate endpoints for general and coding workloads.
  • Providers: volcengine (general) + volcengine-plan (coding)
  • Auth: VOLCANO_ENGINE_API_KEY
  • API: OpenAI-compatible

​
Quick start

  1. Set the API key:
pllan onboard --auth-choice volcengine-api-key
  1. Set a default model:
{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}

​
Non-interactive example

pllan onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Providers and endpoints

ProviderEndpointUse case
volcengineark.cn-beijing.volces.com/api/v3General models
volcengine-planark.cn-beijing.volces.com/api/coding/v3Coding models
Both providers are configured from a single API key. Setup registers both automatically.

​
Available models

  • doubao-seed-1-8 - Doubao Seed 1.8 (general, default)
  • doubao-seed-code-preview - Doubao coding model
  • ark-code-latest - Coding plan default
  • Kimi K2.5 - Moonshot AI via Volcano Engine
  • GLM-4.7 - GLM via Volcano Engine
  • DeepSeek V3.2 - DeepSeek via Volcano Engine
Most models support text + image input. Context windows range from 128K to 256K tokens.

​
Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure VOLCANO_ENGINE_API_KEY is available to that process (for example, in ~/.pllan/.env or via env.shellEnv).