整理本地文档
复现：准备一份无敏感内容的短 Markdown，要求 WorkBuddy 读取后列出三条要点。
通过：回答引用文件内容；既有模型文本请求，也有任务读文件结果。
正在打开页面…
正在加载内容，请稍候。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
在 WorkBuddy 设置 → 模型 → 添加模型中配置自定义模型。默认路径模式会补全 /chat/completions；开启“自定义协议”后，URL 必须写成可直接请求的完整地址 https://api.apizt.com/v1/chat/completions。
适合用 WorkBuddy 处理文件、文档或多步骤任务，并希望用自己的 API 令牌控制模型。只需要独立聊天时，先验证文本，不应直接把任务模式当作通过。
按真实任务判断是否可用
多步骤代理任务
复现：在测试文件夹让 WorkBuddy 新建一份摘要，并检查落盘文件。
通过：最终文件存在、内容符合要求，模型请求与工具事件均没有报错。
先选对协议和请求地址
新版默认模式使用标准路径校验和补全；高级“自定义协议”开启后直接发送到填写的 URL。两种模式都要确认最终请求是 POST /v1/chat/completions。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
模型入口：设置 → 模型 → 添加模型 → 自定义
默认路径模式：按当前界面填写基础地址，核对最终 /v1/chat/completions
自定义协议开启：完整 URL https://api.apizt.com/v1/chat/completions
API Key：apizt 令牌
模型 ID：控制台可用模型的完整 ID这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 WorkBuddy 自定义模型怎么接 配置与验证清单照这个顺序接入
- 01
确定地址模式
先记录 WorkBuddy 版本和“自定义协议”开关。默认模式不要重复拼接路径；开关开启时直接填写完整请求端点。
- 02
填写模型与能力
模型 ID 与当前令牌授权一致。工具调用、图片输入和推理选项只开启已确认的能力；过多勾选不会补齐上游能力。
- 03
选择模型并运行任务
保存后在当前对话的模型选择器选择新模型。先问一句话，再在测试目录执行一次读文件或写文件任务。
对照工具配置与验证顺序
验证到哪一步？
WorkBuddy 官方文档说明默认路径补全、“自定义协议”直连、模型本地保存和对话选择器。
- 现有依据
- 官方行为已核对
- 验证边界
- 本地教程截图没有精确版本；没有 WorkBuddy 客户端带密钥任务实测。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
这个工具的费用怎样算
WorkBuddy 多步骤任务会产生多轮模型请求，长上下文和重复传输会抬高输入用量。预算以一整个任务的请求与实扣合计，不能只看第一次回答。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| 保存成功但请求 404 | 完整 URL 模式只填 /v1，或默认模式重复拼接了 /chat/completions。 | 确认开关状态和实际请求路径。 |
| 聊天成功，文件任务失败 | 模型可能缺少 tool_calls 能力，或工具返回格式与代理模式不匹配。 | 分别保存文本响应与第一次工具调用的脱敏错误。 |
| 改了模型仍调用旧配置 | 已有 models.json 条目与 UI 模型并存，或当前会话未重新选择。 | 先从 UI 查看并编辑当前条目，不覆盖完整配置文件。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
先验证一句短文本；需要 Agent 时，再授权读取一个无敏感内容的测试文件，分别记录文字回答与工具调用结果。
查看 WorkBuddy 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
WorkBuddy 自定义模型只填 /v1 为什么保存失败？
高级配置启用自定义协议时会直接使用所填完整 URL，Chat Completions 应填写实际端点。核对当前界面和版本，不同时创建与旧 models.json 冲突的条目。
WorkBuddy 自定义模型能回复但工具调用失败怎么办？
检查模型与网关是否真实支持 tool_calls、工具参数及结果回传，再检查客户端授权。用一个测试文件分别记录读取和最终回答，能力开关不能让模型自动获得工具支持。
WorkBuddy 应该填写哪个 API 地址？
自定义 Chat Completions 模型的最终 URL 应为 https://api.apizt.com/v1/chat/completions。新版默认会校验补全路径；开启高级配置中的“自定义协议”时直接使用所填完整 URL，不能只填 /v1。
终端请求成功，为什么客户端仍然失败？
旧版 models.json 和新版界面可能并存；从当前界面编辑同一模型，不另外创建冲突条目。 文本回答成功但 Agent 报错时，检查 tool_calls 的返回格式和工具结果回传，不反复换 Key。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。