千问办公完整接入教程
从官方下载、注册登录，到添加启用路由的 OpenAI 兼容模型并完成第一次调用。 本教程按千问办公 Windows 客户端的真实界面和字段编写。
千问办公的“服务地址”填写 SDK Base URL https://api.actuateai.cn/v1。 它会自行拼接请求路径，因此不要填写完整的 /chat/completions 地址。
“模型”入口由千问办公按账号开放。如果设置中没有“模型”，表示当前千问办公账号尚未获得 自定义模型权限，需要先由千问办公开通；这不是启用路由的密钥或接口故障。
- 1
- 2
注册或登录千问办公
首次启动后点击“登录/注册”，按客户端提示完成人工验证和登录。 千问办公账号与启用路由账号相互独立，登录完成后再配置模型服务。
首次启动页：点击“登录/注册”后由用户本人完成验证 - 3
- 4
打开“设置 → 模型”
登录千问办公后打开设置，在设置列表中选择“模型”，然后点击“添加模型”。 空列表会提示可添加 OpenAI 或 Anthropic 兼容模型，本平台请选择“OpenAI 兼容”。
入口名称是“模型”，不是“连接器”或“MCP”。 - 5
填写启用路由配置
协议选择“OpenAI 兼容”；服务地址复制下方地址；API Key 粘贴完整的
qy-密钥；模型 ID 填写模型目录中的精确QY-ID。 “显示名称”可按需要填写，不影响实际调用。https://api.actuateai.cn/v1协议OpenAI 兼容服务地址https://api.actuateai.cn/v1API Key完整 qy- 密钥模型 ID模型目录中的完整 QY- ID - 6
设置上下文与图片能力
高级配置中的最大输入和输出 Token 不要超过模型目录标注的范围；不确定时使用较保守的值。 只有模型目录明确标注“图片输入”时才开启“图片支持”。该开关表示模型能看图， 不代表能够生成图片。
- 7
保存并验证模型
点击“添加”后，千问办公会校验服务地址、API Key 和模型 ID。保存成功后， 在新任务的模型选择器里选中刚添加的模型，先发送“请回复连接成功”完成基础验证。 添加其他模型时可以复用同一服务地址和 API Key，只更换模型 ID。
常见问题排查
- 服务地址校验失败：确认填写的是
https://api.actuateai.cn/v1，不要追加/chat/completions。 - API Key 无效：重新复制创建时显示的完整密钥，不要使用网站列表中的脱敏文本。
- 模型 ID 无效：确认完整包含
QY-，且密钥和当前空间有权使用该模型。 - 图片无法使用：关闭“图片支持”后先测文本，再核对模型目录是否明确标注图片输入。
- 配置暂时无法校验：先检查网络，稍后重试；不要连续创建多条重复配置。