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
Verify It
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
| 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 |
https://api.z.ai); switch provider.base_url to https://open.bigmodel.cn for CN accounts
Related Docs
- 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.