927AI API 文档
官网控制台模型与价格文档首页
官网控制台模型与价格文档首页
  1. 开发工具接入
  • 快速开始
    • 欢迎使用
    • 价格说明
  • 开发工具接入
    • 开发工具接入
    • Claude Code
    • Codex
    • Cursor
    • OpenCode
    • Grok CLI
    • Gemini CLI
    • OpenClaw
    • Hermes
    • WorkBuddy
    • 常见问题
  • 模型 API 接口
    • OpenAI 格式
      • 文本生成
        • Completions
        • Responses
      • 图片
        • 图片生成
        • 图片编辑
    • Anthropic 格式
      • 文本生成
        • Messages
    • Gemini 格式
      • 模型
        • Models
      • 内容生成
        • Generate Content
        • Stream Generate Content
      • 向量化
        • Embed Content
        • Batch Embed Contents
    • 视频生成API
      • Seedance
        • OpenAI 格式
          • 创建视频生成任务
          • 查询视频生成任务
          • 下载生成的视频
        • 火山方舟格式
          • 创建视频生成任务
          • 查询视频生成任务
      • Grok
        • OpenAI 格式
          • 创建 Grok 视频任务
          • 查询 Grok 视频任务
          • 下载 Grok 视频
      • Wan
        • OpenAI 格式
          • 创建 Wan 视频任务
          • 查询 Wan 视频任务
          • 下载 Wan 视频
  1. 开发工具接入

WorkBuddy

WorkBuddy 接入 927AI#

在 WorkBuddy 中添加自定义模型,填入 927AI 的接口地址、API Key 和模型名称,即可开始使用。

接入前准备#

1.
安装并登录 WorkBuddy。
2.
在 927AI 控制台 创建 API Key。
3.
在 模型与价格 页面确认所用分组支持目标模型。本文以 gpt-5.6-sol 为例,模型名称必须与平台提供的模型 ID 完全一致。

第一步:打开模型设置#

点击 WorkBuddy 左下角的账户菜单,选择 设置,再点击左侧的 模型。在“自定义模型”区域点击 添加模型。
WorkBuddy 设置中的模型页面,右上角为添加模型按钮

第二步:填写 927AI 配置#

在“供应商”下拉列表中找到“其他”分组,选择 自定义。
按下表填写:
配置项填写内容
供应商自定义
接口地址(国内节点)https://vip.927ai.ai/v1/chat/completions
接口地址(海外节点)https://www.927ai.ai/v1/chat/completions
API Key在 927AI 控制台创建的 API Key
模型名称gpt-5.6-sol,或你的分组支持的其他精确模型 ID
国内用户优先选择国内节点,海外用户选择海外节点。接口地址请完整填写,保留末尾的 /v1/chat/completions。
WorkBuddy 自定义模型配置,填写 927AI 接口地址和模型名称

高级配置怎么选#

选项配置说明
工具调用需要执行工具任务时保持勾选,所选模型也必须支持工具调用
图片输入仅在所选模型支持图片输入且需要使用时勾选
思考模式按模型能力和实际兼容情况启用;首次接入可保持未勾选
自定义协议保持未勾选,927AI 使用标准 OpenAI 兼容接口
输入、输出首次接入可留空,沿用界面默认值;如需指定上限,不要超过模型支持范围

第三步:测试连接并保存#

确认接口地址、API Key 和模型名称都已填写,点击 测试连接。如果测试失败,先按下方常见问题检查配置;测试通过后点击 保存。
保存后,自定义模型会出现在“设置 → 模型”的列表中。列表每一项右侧提供编辑、测试连接和删除入口。

第四步:选择模型并验证对话#

1.
关闭设置,返回“新建任务”。
2.
点击输入框下方的当前模型名称,在自定义模型列表中选择刚添加的模型。
3.
发送以下消息:
你好,请简单介绍一下你能做什么。
收到正常回复,且 927AI 控制台出现对应的用量记录,即表示接入成功。

常见问题#

找不到“自定义”供应商#

进入“设置 → 模型 → 添加模型”,展开供应商列表,向下找到“其他 → 自定义”。

返回 401 或密钥无效#

确认填写的是 927AI API Key,检查复制时是否带入空格或换行,并确认密钥没有被禁用或撤销。

返回 404#

检查接口地址是否完整填写为 https://vip.927ai.ai/v1/chat/completions(或海外节点对应地址),避免重复拼接 /v1、/chat/completions,并确认“自定义协议”未勾选。

提示模型不存在或无权访问#

从 模型与价格 页面复制完整模型 ID,并确认当前 API Key 所属分组支持该模型。

余额不足或请求过于频繁#

查看 927AI 控制台中的余额、密钥额度及限流信息。余额不足时补足额度;触发限流时降低并发或稍后重试。

普通对话正常,但工具任务或图片输入失败#

先确认当前任务选中了新添加的模型,再检查模型是否支持所需能力,以及相应高级选项是否启用。

测试连接超时#

检查所选节点是否可访问。中国大陆用户优先使用国内节点,并检查 WorkBuddy“设置 → 通用 → 网络代理”是否与自己的网络环境一致。

密钥保管#

请妥善保管 API Key,不要公开分享密钥或包含密钥的 ~/.workbuddy/models.json 配置文件。

官方参考#

WorkBuddy:模型配置
腾讯云:WorkBuddy 配置示例
上一页
Hermes
下一页
常见问题
Built with