Z.ai

Use this when your team already runs on Z.ai and you want that vendor family to stay explicit in Loong config instead of disappearing behind a generic compatibility route.

At A Glance

Field	Value
Built-in kind	`zai`
Provider group	Direct Hosted Providers
Protocol family	`openai_chat_completions`
Feature family	`openai_compatible`
Auth scheme	`bearer`
Credential envs	ZAI_API_KEY
Aliases	`zai_compatible`, `z.ai`
Default base URL	`https://api.z.ai`
Request endpoint	`https://api.z.ai/api/paas/v4/chat/completions`
Models endpoint	`https://api.z.ai/api/paas/v4/models`

Minimal Config

active_provider = "zai"

[providers.zai]
kind = "zai"
api_key = { env = "ZAI_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	`ZAI_API_KEY`
OAuth env	none
Primary request route	`https://api.z.ai/api/paas/v4/chat/completions`
Primary model-catalog route	`https://api.z.ai/api/paas/v4/models`

Region Endpoints

Variant	Base URL
Global	`https://api.z.ai`
CN	`https://open.bigmodel.cn`

Z.ai / BigModel region endpoint: Global default (https://api.z.ai); switch provider.base_url to https://open.bigmodel.cn for CN accounts

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.

Overview

Get Started

Use Loong

Build On Loong

Reference

Z.ai

Z.ai

At A Glance

Minimal Config

Verify It

Auth And Routing Contract

Region Endpoints

​Z.ai

​At A Glance

​Minimal Config

​Verify It

​Auth And Routing Contract

​Region Endpoints

​Related Docs

Z.ai

At A Glance

Minimal Config

Verify It

Auth And Routing Contract

Region Endpoints

Related Docs