ZCode

更新时间:
复制 MD 格式

在 ZCode 中使用阿里云百炼模型。

快速开始

  1. 1

    获取 API Key

    根据计费方案获取 API Key:

  2. 2

    添加供应商

    在 ZCode 中进入模型设置,在左侧供应商列表底部添加供应商,填写自定义名称。

  3. 3

    选择协议和 Base URL

    ZCode 支持 Anthropic 和 OpenAI 协议,Base URL 不追加 /chat/completions。

    Token Plan

    按量计费

    将 {WorkspaceId} 替换为真实的 Workspace ID。

    • OpenAI Base URL:https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    • Anthropic Base URL:https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic

    Coding Plan

  4. 4

    填写 API Key

    填入所选方案的 API Key。

  5. 5

    填写模型并保存

    按计费方案填写模型 ID,开启启用开关后保存:

  6. 6

    验证

    在 ZCode 中选择已添加的模型,发送一条测试消息。收到模型回复即表示接入成功。

常见问题

如何按量计费接入节省计划与资源包?

按量计费接入方式不变,使用百炼通用 API Key 和 Base URL。购买节省计划或资源包后自动生效,调用费用按抵扣顺序自动抵扣。详情参见节省计划与资源包。

模型未出现在 ZCode 的模型列表中

确认已添加模型、开启启用开关并保存配置。返回模型设置检查供应商和模型条目是否完整。

无法调用模型或返回 401

确认 API Key、Base URL 和模型属于同一方案。Token Plan、Coding Plan 与按量计费的 API Key 互不通用。按量计费还需确认 {WorkspaceId} 已替换为正确地域的 Workspace ID。

请求返回 404 或提示端点不存在

检查 Base URL 是否误加了 /chat/completions。ZCode 使用 Base URL,不追加该路径。