Genesis Docs

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) |

```bash
# 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

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

Verify models are available

```bash
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](/providers/zai).

Related