zCode 接入教程

准备材料

• API 密钥:sk- 开头,还没创建?看创建教程
• 接口地址:https://v1.123336.xyz/v1
• 模型 ID:从模型广场复制,只能添加你分组下的模型

配置步骤

1. 打开 zCode 的 设置,进入 模型设置

   

2. 点击 添加模型供应商,填写:

   • 名称:随意,如 ST API
   • Base URL:https://v1.123336.xyz/v1
   • API Key:粘贴你的 sk- 密钥
   • API 格式：该模型在模型广场标注支持 openai-response 时，选 Responses (/responses)；其他情况按模型详情选择协议

   

3. 点击 添加模型,逐个添加你要用的模型:

   • 模型 ID:从模型广场复制(只能填你分组下的)
   • 上下文窗口 / 最大输出 Token:对照参数速查表填写(能自动获取就自动获取，未提供时保留默认；不要把上下文长度填成最大输出)
   • 输入类型:按模型能力勾选(只启用当前模型与协议支持的输入类型，不要直接照抄截图中的勾选项)

   

4. 保存，回到聊天界面选中添加的模型，先发一句简短消息测试。需要作为子代理使用时，给子代理单独选择模型和对应分组的密钥。

模型 ID 填错会怎样

填了分组外或不存在的 ID,调用时会报 model not found;「获取可用模型」类按钮拉到的列表就是你分组下的全部可选模型。

参数与排错

截图用于定位设置入口，模型名称和参数以当前配置为准。获取不到列表时，先检查密钥、Base URL 和分组；能获取列表但调用失败时，再检查协议与额外参数。不要为了排错同时改动多项配置，详见常见问题。