From 5db5717fdb192a3d9c370babf9597ed86f62088e Mon Sep 17 00:00:00 2001 From: pete Date: Thu, 26 Mar 2026 09:18:19 +0100 Subject: [PATCH 1/2] docs: Add Z.AI Coding Plan provider example ## Summary - Add zai-coding to Providers table - Add Z.AI Coding Plan to All Supported Vendors table - Add Z.AI Coding Plan configuration example with troubleshooting note --- docs/providers.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/providers.md b/docs/providers.md index 42d46189a..7a961561c 100644 --- a/docs/providers.md +++ b/docs/providers.md @@ -11,6 +11,7 @@ | ------------ | --------------------------------------- | ------------------------------------------------------------ | | `gemini` | LLM (Gemini direct) | [aistudio.google.com](https://aistudio.google.com) | | `zhipu` | LLM (Zhipu direct) | [bigmodel.cn](https://bigmodel.cn) | +| `zai-coding` | LLM (Z.AI Coding Plan) | [docs.z.ai](https://docs.z.ai/devpack/overview) | | `volcengine` | LLM(Volcengine direct) | [volcengine.com](https://www.volcengine.com/activity/codingplan?utm_campaign=PicoClaw&utm_content=PicoClaw&utm_medium=devrel&utm_source=OWO&utm_term=PicoClaw) | | `openrouter` | LLM (recommended, access to all models) | [openrouter.ai](https://openrouter.ai) | | `anthropic` | LLM (Claude direct) | [console.anthropic.com](https://console.anthropic.com) | @@ -47,6 +48,7 @@ This design also enables **multi-agent support** with flexible provider selectio | **OpenAI** | `openai/` | `https://api.openai.com/v1` | OpenAI | [Get Key](https://platform.openai.com) | | **Anthropic** | `anthropic/` | `https://api.anthropic.com/v1` | Anthropic | [Get Key](https://console.anthropic.com) | | **智谱 AI (GLM)** | `zhipu/` | `https://open.bigmodel.cn/api/paas/v4` | OpenAI | [Get Key](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) | +| **Z.AI Coding Plan** | `openai/` | `https://api.z.ai/api/coding/paas/v4` | OpenAI | [Get Zhipu Key](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) | | **DeepSeek** | `deepseek/` | `https://api.deepseek.com/v1` | OpenAI | [Get Key](https://platform.deepseek.com) | | **Google Gemini** | `gemini/` | `https://generativelanguage.googleapis.com/v1beta` | OpenAI | [Get Key](https://aistudio.google.com/api-keys) | | **Groq** | `groq/` | `https://api.groq.com/openai/v1` | OpenAI | [Get Key](https://console.groq.com) | @@ -238,6 +240,21 @@ For direct Anthropic API access or custom endpoints that only support Anthropic' PicoClaw strips only the outer `litellm/` prefix before sending the request, so proxy aliases like `litellm/lite-gpt4` send `lite-gpt4`, while `litellm/openai/gpt-4o` sends `openai/gpt-4o`. +**Z.AI Coding Plan** + +If the standard Zhipu endpoint (`https://open.bigmodel.cn/api/paas/v4`) returns 429 (code 1113: insufficient balance), try using the Z.AI Coding Plan endpoint instead: + +```json +{ + "model_name": "glm-4.7", + "model": "openai/glm-4.7", + "api_key": "your-zhipu-api-key", + "api_base": "https://api.z.ai/api/coding/paas/v4" +} +``` + +**Note:** The Z.AI Coding Plan endpoint and standard Zhipu endpoint use the same API key format but have separate billing. If you encounter 429 errors with the standard Zhipu endpoint, the Z.AI Coding Plan endpoint may have available balance. + #### Load Balancing Configure multiple endpoints for the same model name—PicoClaw will automatically round-robin between them: From 06be65e2e2d20210b362283e07b461a7db57d4a1 Mon Sep 17 00:00:00 2001 From: apnea Date: Thu, 26 Mar 2026 11:09:09 +0100 Subject: [PATCH 2/2] Fix API key links for Z.AI API key and add Z.AI example Updated API key links for Z.AI Coding Plan and explicit Z.AI config example --- docs/providers.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/providers.md b/docs/providers.md index 7a961561c..52c40d9e9 100644 --- a/docs/providers.md +++ b/docs/providers.md @@ -11,7 +11,7 @@ | ------------ | --------------------------------------- | ------------------------------------------------------------ | | `gemini` | LLM (Gemini direct) | [aistudio.google.com](https://aistudio.google.com) | | `zhipu` | LLM (Zhipu direct) | [bigmodel.cn](https://bigmodel.cn) | -| `zai-coding` | LLM (Z.AI Coding Plan) | [docs.z.ai](https://docs.z.ai/devpack/overview) | +| `zai-coding` | LLM (Z.AI Coding Plan) | [z.ai](https://z.ai/manage-apikey/apikey-list) | | `volcengine` | LLM(Volcengine direct) | [volcengine.com](https://www.volcengine.com/activity/codingplan?utm_campaign=PicoClaw&utm_content=PicoClaw&utm_medium=devrel&utm_source=OWO&utm_term=PicoClaw) | | `openrouter` | LLM (recommended, access to all models) | [openrouter.ai](https://openrouter.ai) | | `anthropic` | LLM (Claude direct) | [console.anthropic.com](https://console.anthropic.com) | @@ -48,7 +48,7 @@ This design also enables **multi-agent support** with flexible provider selectio | **OpenAI** | `openai/` | `https://api.openai.com/v1` | OpenAI | [Get Key](https://platform.openai.com) | | **Anthropic** | `anthropic/` | `https://api.anthropic.com/v1` | Anthropic | [Get Key](https://console.anthropic.com) | | **智谱 AI (GLM)** | `zhipu/` | `https://open.bigmodel.cn/api/paas/v4` | OpenAI | [Get Key](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) | -| **Z.AI Coding Plan** | `openai/` | `https://api.z.ai/api/coding/paas/v4` | OpenAI | [Get Zhipu Key](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) | +| **Z.AI Coding Plan** | `openai/` | `https://api.z.ai/api/coding/paas/v4` | OpenAI | [Get Key](https://z.ai/manage-apikey/apikey-list) | | **DeepSeek** | `deepseek/` | `https://api.deepseek.com/v1` | OpenAI | [Get Key](https://platform.deepseek.com) | | **Google Gemini** | `gemini/` | `https://generativelanguage.googleapis.com/v1beta` | OpenAI | [Get Key](https://aistudio.google.com/api-keys) | | **Groq** | `groq/` | `https://api.groq.com/openai/v1` | OpenAI | [Get Key](https://console.groq.com) | @@ -164,6 +164,17 @@ If `voice.model_name` is not configured, PicoClaw will continue to fall back to } ``` +**Z.AI Coding Plan (GLM)** +> Z.AI and 智谱 AI are two brands of the same provider. For the Z.AI Coding Plan use the `openai` model key and the api base as follows, rather than the zhipu config +```json +{ + "model_name": "glm-4.7", + "model": "openai/glm-4.7", + "api_key": "your-z.ai-key" + "api_base": "https://api.z.ai/api/coding/paas/v4" +} +``` + **DeepSeek** ```json