Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fluffbuzz.com/llms.txt

Use this file to discover all available pages before exploring further.

The Volcengine provider gives access to Doubao models and third-party models hosted on Volcano Engine, with separate endpoints for general and coding workloads.
DetailValue
Providersvolcengine (general) + volcengine-plan (coding)
AuthVOLCANO_ENGINE_API_KEY
APIOpenAI-compatible

​
Getting started

1

Set the API key

Run interactive onboarding:
fluffbuzz onboard --auth-choice volcengine-api-key
This registers both the general (volcengine) and coding (volcengine-plan) providers from a single API key.
2

Set a default model

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

Verify the model is available

fluffbuzz models list --provider volcengine
fluffbuzz models list --provider volcengine-plan
For non-interactive setup (CI, scripting), pass the key directly:
fluffbuzz 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.

​
Built-in catalog

Model refNameInputContext
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000

​
Advanced configuration

fluffbuzz onboard --auth-choice volcengine-api-key currently sets volcengine-plan/ark-code-latest as the default model while also registering the general volcengine catalog.
During onboarding/configure model selection, the Volcengine auth choice prefers both volcengine/* and volcengine-plan/* rows. If those models are not loaded yet, FluffBuzz falls back to the unfiltered catalog instead of showing an empty provider-scoped picker.
If the Gateway runs as a daemon (launchd/systemd), make sure VOLCANO_ENGINE_API_KEY is available to that process (for example, in ~/.fluffbuzz/.env or via env.shellEnv).
When running FluffBuzz as a background service, environment variables set in your interactive shell are not automatically inherited. See the daemon note above.

Model selection

Choosing providers, model refs, and failover behavior.

Configuration

Full config reference for agents, models, and providers.

Troubleshooting

Common issues and debugging steps.

FAQ

Frequently asked questions about FluffBuzz setup.