Skip to main content

​
Z.AI

Z.AI is the API platform for GLM models. It provides REST APIs for GLM and uses API keys for authentication. Create your API key in the Z.AI console. gensparx uses the zai provider with a Z.AI API key.

​
CLI setup

# Coding Plan Global, recommended for Coding Plan users
gensparx onboard --auth-choice zai-coding-global

# Coding Plan CN (China region), recommended for Coding Plan users
gensparx onboard --auth-choice zai-coding-cn

# General API
gensparx onboard --auth-choice zai-global

# General API CN (China region)
gensparx onboard --auth-choice zai-cn

# Or let Gensparx auto-detect from your API key
gensparx onboard --auth-choice zai-api-key
# Non-interactive
gensparx onboard --zai-api-key "$ZAI_API_KEY"

​
Config snippet

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

​
Notes

  • GLM models are available as zai/<model> (example: zai/glm-5).
  • tool_stream is enabled by default for Z.AI tool-call streaming. Set agents.defaults.models["zai/<model>"].params.tool_stream to false to disable it.
  • See /providers/glm for the model family overview.
  • Z.AI uses Bearer auth with your API key.