Models / Providers

GLM models

GLM is a model family (not a company) available through the Z.AI platform. In Genesis, GLM models are accessed via the zai provider and model IDs like zai/glm-5.

Getting started

Choose an auth route and run onboarding

Pick the onboarding choice that matches your Z.AI plan and region:

Auth choice Best for
zai-api-key Generic API-key setup with endpoint auto-detection
zai-coding-global Coding Plan users (global)
zai-coding-cn Coding Plan users (China region)
zai-global General API (global)
zai-cn General API (China region)
# Example: generic auto-detect
genesis onboard --auth-choice zai-api-key

# Example: Coding Plan global
genesis onboard --auth-choice zai-coding-global

Set GLM as the default model

genesis config set agents.defaults.model.primary "zai/glm-5.1"

Verify models are available

genesis models list --provider zai

Config example

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}

zai-api-key lets Genesis detect the matching Z.AI endpoint from the key and apply the correct base URL automatically. Use the explicit regional choices when you want to force a specific Coding Plan or general API surface.

Built-in catalog

Genesis currently seeds the bundled zai provider with these GLM refs:

Model Model
glm-5.1 glm-4.7
glm-5 glm-4.7-flash
glm-5-turbo glm-4.7-flashx
glm-5v-turbo glm-4.6
glm-4.5 glm-4.6v
glm-4.5-air
glm-4.5-flash
glm-4.5v

The default bundled model ref is zai/glm-5.1. GLM versions and availability can change; check Z.AI's docs for the latest.

Advanced configuration

Endpoint auto-detection

When you use the zai-api-key auth choice, Genesis inspects the key format to determine the correct Z.AI base URL. Explicit regional choices (zai-coding-global, zai-coding-cn, zai-global, zai-cn) override auto-detection and pin the endpoint directly.

Provider details

GLM models are served by the zai runtime provider. For full provider configuration, regional endpoints, and additional capabilities, see Z.AI provider docs.