elizaos--eliza/plugins/plugin-zai

@elizaos/plugin-zai

First-party z.ai model provider plugin for elizaOS.

This plugin targets z.ai's general OpenAI-compatible API and supports:

• TEXT_SMALL, TEXT_LARGE

Install

eliza plugins install @elizaos/plugin-zai

Configuration

Variable	Required	Default	Description
ZAI_API_KEY	Yes	–	z.ai API key
Z_AI_API_KEY	No	–	Legacy alias accepted when ZAI_API_KEY is unset
ZAI_BASE_URL	No	https://api.z.ai/api/paas/v4	General API base URL. Coding Plan and Anthropic-compatible coding-tool endpoints are rejected here.
ZAI_SMALL_MODEL	No	glm-4.5-air	Small model id
ZAI_LARGE_MODEL	No	glm-5.1	Large model id
ZAI_THINKING_TYPE	No	–	Optional thinking mode override: enabled or disabled; unset uses z.ai's default
ZAI_COT_BUDGET	No	–	Deprecated compatibility setting. Positive values enable thinking mode; z.ai does not accept Anthropic budget_tokens.
ZAI_COT_BUDGET_SMALL	No	–	Deprecated compatibility setting for small-model calls
ZAI_COT_BUDGET_LARGE	No	–	Deprecated compatibility setting for large-model calls

Prefer ZAI_API_KEY for new configuration. Z_AI_API_KEY exists only for compatibility with older z.ai wiring.

This plugin targets z.ai's general API only. Do not point it at https://api.z.ai/api/coding/paas/v4 or https://api.z.ai/api/anthropic; those paths are reserved for z.ai's coding tools and getBaseURL rejects them.

Usage

import { AgentRuntime, ModelType } from "@elizaos/core";
import zaiPlugin from "@elizaos/plugin-zai";

const runtime = new AgentRuntime({ plugins: [zaiPlugin] });

const text = await runtime.useModel(ModelType.TEXT_LARGE, {
  prompt: "Write a haiku about local-first AI.",
});

console.log(text);