> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loongclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Volcengine

> Configure the Volcengine provider profile in Loong.

# 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

```toml theme={null}
active_provider = "volcengine"

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

## Verify It

```bash theme={null}
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.

## Related Docs

* Continue to [Providers And Models](/use-loong/providers-and-models) when you still need the broader chooser page.
* Continue to [Provider Guides](/use-loong/provider-guides/index) for the full built-in provider matrix.
* Continue to [Provider Recipes](/use-loong/provider-recipes) for representative rollout recipes.
* Continue to [Configuration Patterns](/use-loong/configuration-patterns) for the shared provider-profile shape.
* Continue to [Volcengine Plus Feishu Or Lark](/use-loong/volcengine-feishu-lark-playbook) when the provider choice already belongs to that rollout path.