Skip to main content

BytePlus

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

At A Glance

FieldValue
Built-in kindbyteplus
Provider groupPlatform-First Hosted
Protocol familyopenai_chat_completions
Feature familyvolcengine
Auth schemebearer
Credential envsBYTEPLUS_API_KEY, ARK_API_KEY
Aliasesbyteplus_compatible
Default base URLhttps://ark.ap-southeast.bytepluses.com/api/v3
Request endpointhttps://ark.ap-southeast.bytepluses.com/api/v3/chat/completions
Models endpointhttps://ark.ap-southeast.bytepluses.com/api/v3/models

Minimal Config

active_provider = "byteplus"

[providers.byteplus]
kind = "byteplus"
api_key = { env = "BYTEPLUS_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 envBYTEPLUS_API_KEY
OAuth envnone
Primary request routehttps://ark.ap-southeast.bytepluses.com/api/v3/chat/completions
Primary model-catalog routehttps://ark.ap-southeast.bytepluses.com/api/v3/models

Operator Notes

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