客户端配置与 Start Plan 额度

通过 getClientConfigs() API 获取的客户端配置结构，以及 Start Plan 的真实额度数字。

---

客户端配置 API

GET https://zcode.z.ai/api/v1/client/configs?app_version=3.0.1

不需要任何认证，任何人都可以访问。

完整响应结构

// source: host/index.js — client configs 解析
// 请求频率: 最多每 1 小时请求一次 (o5 = 3600 * 1000)
// 超时: 15 秒 (Jc = 15 * 1000)

async function getClientConfigs() {
    // 缓存检查
    if (this.clientConfigSnapshot && this.clientConfigSnapshotExpiresAt > Date.now())
        return this.clientConfigSnapshot;

    // 去重：正在请求中的等待
    if (this.clientConfigRequest)
        return await this.clientConfigRequest;

    // 构建 URL
    let url = new URL("https://zcode.z.ai/api/v1/client/configs");
    url.searchParams.set("app_version", appVersion);
    url.searchParams.set("platform", platform);

    // 发起请求
    this.clientConfigRequest = apiClient.request(url, { method: "GET", timeoutMs: 15000 });
    let response = await this.clientConfigRequest;
    
    // 缓存 1 小时
    this.clientConfigSnapshot = response;
    this.clientConfigSnapshotExpiresAt = Date.now() + 3600000;
    return response;
}

---

配置项一览

Key	说明	是否需要认证
startPlanPreview	Start Plan 预览/权益	❌ 不需要
codingPlanStaticProducts	Coding Plan 产品定价	❌ 不需要
codingPlanBillingDiscount	计费折扣信息	❌ 不需要
captcha	验证码配置	❌ 不需要
feedbackUrl	反馈链接	❌ 不需要

---

Start Plan 免费额度（真实数字！）

实时验证（2026-08-18）

直接请求 GET https://zcode.z.ai/api/v1/client/configs?app_version=3.0.1（无需任何认证），返回的 data.configs.startPlanPreview 即为免费额度配置。此接口公开可访问，无论账号登录与否返回一致的权益。

响应

{
    "entitlements": [
        {
            "grantUnits": 3000000,
            "meter": "model_usage",
            "period": "daily",
            "showName": "GLM-5.3",
            "unitType": "token"
        },
        {
            "grantUnits": 2000000,
            "meter": "model_usage",
            "period": "daily",
            "showName": "GLM-5-Turbo",
            "unitType": "token"
        }
    ],
    "name": "Start Plan",
    "planId": "zcode-v3-start-plan"
}

额度汇总

模型	每日额度	周期	单位
GLM-5.3（旗舰，2026-08 时点官方已将免费档从 GLM-5.2 升级为 5.3）	3,000,000 tokens	每日	token
GLM-5-Turbo (≈ Sonnet 级别)	2,000,000 tokens	每日	token

每日 3M + 2M token，两模型独立计算，每日重置。不是之前猜测的"5 小时 prompt 池"。 注意：免费档 showName 官方可随时调整（2026-06 分析时为 GLM-5.2，2026-08-18 实测已为 GLM-5.3），grantUnits 数字保持不变。

账号实际权益验证（需登录 JWT）

• GET https://api.z.ai/api/biz/subscription/list（Bearer JWT）→ 返回 {"code":200,"data":[]}，即无付费订阅时 data 为空数组，免费用户即该状态。
• GET https://api.z.ai/api/monitor/usage/quota/limit → 免费无 coding plan 时会返回 {"code":500,"msg":"当前用户不存在coding plan"}。（注意：zcode.z.ai 路径的 billing/current 若 JWT 过期会返回 401，不代表免费额度不存在——免费额度是服务器按账号在模型调用时自动授予，不体现在此接口。）

结论：免费额度是真实存在且公开可验证的——startPlanPreview 无需登录即可从官方 API 拉到每日 3M + 2M token 的配置；登录后真正调用时才从服务器侧扣减。

---

Coding Plan 定价

ZCode 提供两套定价体系，按渠道区分：

BigModel 渠道

产品	价格	说明
GLM Coding Lite	¥49/月	3x Claude Pro 用量额度
GLM Coding Pro	¥149/月	5x Lite 用量额度 + Lite 全量权益
GLM Coding Pro Max	¥469/月	20x Lite 额度 + Pro 全量权益

Z.AI 渠道（更便宜！）

产品	价格	说明
GLM Coding Lite	¥18/月	基础编程套餐
GLM Coding Pro	¥72/月	高级编程套餐

计费折扣

{
    "en-US": {
        "badgeBody": "150% Quota",
        "cardTitle": "Limited-time 150% Quota Campaign",
        "cardBody": "Upgrade your Coding Plan to get 150% quota during the campaign period"
    },
    "zh-CN": {
        "badgeBody": "150% 额度",
        "cardTitle": "限时 150% 额度活动",
        "cardBody": "活动期间订阅 Coding Plan 可享受 150% 专属额度"
    }
}

---

数据流

sequenceDiagram
    participant App as ZCode App
    participant ZCode as zcode.z.ai
    participant User as 用户

    App->>ZCode: GET /api/v1/client/configs
    Note over App,ZCode: 无需认证, 1 小时缓存

    ZCode-->>App: startPlanPreview
    Note over App: 展示 Start Plan 权益给用户

    ZCode-->>App: codingPlanStaticProducts
    Note over App: 展示产品列表和价格

    App->>User: 用户看到免费额度
    App->>User: 或 Coding Plan 付费选项

    alt 用户选择 Start Plan
        App->>ZCode: GET /api/v1/zcode-plan/billing/current
        Note over App,ZCode: 检查是否已激活 (需认证)
        ZCode-->>App: plans[].status === "active" ?
    end

---

消费端代码

// source: host/index.js — 验证 entitlement 结构
function isValidStartPlanPreviewEntitlement(entitlement) {
    return typeof entitlement?.grantUnits === "number"
        && typeof entitlement.meter === "string"
        && typeof entitlement.period === "string"
        && typeof entitlement.showName === "string"
        && typeof entitlement.unitType === "string";
}

// source: host/index.js — 解析客户端配置
function unwrapClientConfigStartPlanPreview(response) {
    if (response.code !== 0) throw new Error("config request failed");
    
    let preview = response.data?.configs?.startPlanPreview;
    if (!preview) return null;
    
    // 验证结构完整性
    if (typeof preview.planId !== "string"
        || typeof preview.name !== "string"
        || !Array.isArray(preview.entitlements))
        throw new Error("invalid Start Plan preview");
    
    return {
        planId: preview.planId,           // "zcode-v3-start-plan"
        name: preview.name,               // "Start Plan"
        entitlements: preview.entitlements.filter(isValid)
    };
}

// 解析产品
function unwrapClientConfigStaticProducts(response) {
    return response.data?.configs?.codingPlanStaticProducts;
}

// 解析折扣
function unwrapClientConfigBillingDiscount(response) {
    let configs = response.data?.configs;
    if (configs && "codingPlanBillingDiscount" in configs) {
        return configs.codingPlanBillingDiscount;
    }
    return null;
}