Skip to main content

​
Volcengine

Common hosted first-run lanes when you want a short reviewed path without hiding the provider family. This page covers the built-in volcengine provider kind directly.

​
At A Glance

FieldValue
Built-in kindvolcengine
Provider groupPlatform-First Hosted
Protocol familyopenai_chat_completions
Feature familyvolcengine
Auth schemebearer
Credential envsARK_API_KEY
Aliasesvolcengine_custom, volcengine_compatible, doubao, ark
Default base URLhttps://ark.cn-beijing.volces.com
Request endpointhttps://ark.cn-beijing.volces.com/api/v3/chat/completions
Models endpointhttps://ark.cn-beijing.volces.com/api/v3/models

​
Minimal Config

active_provider = "volcengine"

[providers.volcengine]
kind = "volcengine"
api_key = { env = "ARK_API_KEY" }
model = "auto"

​
Verify It

loong doctor
loong list-models
loong ask --message "Say hello and name the active provider."
If list-models is unreliable for this account or region, pin an explicit provider.model or add preferred_models instead of leaving recovery implicit.

​
Auth And Routing Contract

ContractValue
Auth optionalno
Model probe auth optionalno
Default API key envARK_API_KEY
OAuth envnone
Primary request routehttps://ark.cn-beijing.volces.com/api/v3/chat/completions
Primary model-catalog routehttps://ark.cn-beijing.volces.com/api/v3/models

​
Operator Notes

  • Loong’s Volcengine OpenAI-compatible path uses provider.api_key / ARK_API_KEY and sends Authorization: Bearer <ARK_API_KEY>; AK/SK request signing is not used on this path.
  • This is the general hosted ARK lane. Use volcengine_coding when coding traffic should stay on the dedicated coding route.