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

Field	Value
Built-in kind	`volcengine`
Provider group	Platform-First Hosted
Protocol family	`openai_chat_completions`
Feature family	`volcengine`
Auth scheme	`bearer`
Credential envs	ARK_API_KEY
Aliases	`volcengine_custom`, `volcengine_compatible`, `doubao`, `ark`
Default base URL	`https://ark.cn-beijing.volces.com`
Request endpoint	`https://ark.cn-beijing.volces.com/api/v3/chat/completions`
Models endpoint	`https://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 runtime models list
loong ask --message "Say hello and name the active provider."

If runtime models list 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

Contract	Value
Auth optional	no
Model probe auth optional	no
Default API key env	`ARK_API_KEY`
OAuth env	none
Primary request route	`https://ark.cn-beijing.volces.com/api/v3/chat/completions`
Primary model-catalog route	`https://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.

Continue to Providers And Models when you still need the broader chooser page.
Continue to Provider Guides for the full built-in provider matrix.
Continue to Provider Recipes for representative rollout recipes.
Continue to Configuration Patterns for the shared provider-profile shape.
Continue to Volcengine Plus Feishu Or Lark when the provider choice already belongs to that rollout path.

Overview

Get Started

Use Loong

Build On Loong

Reference

Volcengine

Volcengine

At A Glance

Minimal Config

Verify It

Auth And Routing Contract

Operator Notes

​Volcengine

​At A Glance

​Minimal Config

​Verify It

​Auth And Routing Contract

​Operator Notes

​Related Docs

Volcengine

At A Glance

Minimal Config

Verify It

Auth And Routing Contract

Operator Notes

Related Docs