Grok API 怎么接入 DSH?
手把手教你把 xAI Grok API(grok-4.7)接入 DSH:一张表分清 Grok 与 Groq,附密钥获取、自定义服务商 5 格照抄配置与 401/404 排错表。
本页内容

想把马斯克旗下 xAI 公司的 Grok 大模型(比如主力款 grok-4.7)接进 DeepSeek Harness(简称 DSH)里写代码、读文档?
很多新手第一次配的时候之所以连不上,99% 是栽在两个小细节上:一是把 Grok 和名字只差一个字母的另一家公司 Groq 弄混了;二是在添加自定义服务商时填错了接口地址或协议。照着下面一步步做,5 分钟就能跑通。
第一步先认清门牌:Grok 和 Groq 根本不是一家公司!
在动手领密钥之前,先看一眼这张对比表,千万别去错网站、填错卡片:
| 容易搞混的名字 | 背后是哪家公司? | 官方网站 / 控制台 | 接口根地址(Base URL) | 在 DSH 里怎么选? |
|---|---|---|---|---|
| Grok(本文教的这个) | 马斯克旗下的 xAI 大模型公司 | console.x.ai(文档在 docs.x.ai) | https://api.x.ai/v1 | 点 Add a custom provider 手动填 5 个格子 |
| Groq(末尾是字母 q) | 做高速推理芯片的另一家美国公司 | console.groq.com | https://api.groq.com/openai/v1 | DSH 里自带的 Groq 卡片是给它用的,不能填 xAI 的密钥 |
只要记牢:xAI 的 Grok 密钥绝对不能填进 DSH 内置的 Groq 卡片里,否则 100% 报密码错误!
零基础 4 步实操:把 xAI Grok 接进 DSH
确认你电脑上已经装好并能打开 DSH(还没装可先看 电脑端 5 分钟安装教程),然后按顺序做下面 4 步:
第 1 步:去 xAI 控制台领一把 API Key(密钥)
- 在浏览器打开 xAI 官方开发者文档与控制台入口(参考 xAI 官方 Quickstart),注册并登录你的账号。
- 先在后台的账单(Billing)页面确认账户里有可用额度(xAI 官方价格表 按实际读写字数扣费;注意你在 X 推特上开通的 Premium 会员费跟这里的 API 余额是分开的,不通用)。
- 进入
API Keys页面新建一把密钥,把弹出来的整串密码立刻复制存进备忘录(千万别把密钥截图发到群里或写进公开代码仓库)。 - 顺手在后台的 官方模型目录 看一眼你账号当前开放的模型代号,目前官方示例主力型号是
grok-4.7。
第 2 步:(可选但很省心)先用一行命令确认你的 Key 能通
如果你怕等会儿填进软件报错分不清是谁的问题,可以先打开电脑命令行窗口(Windows 按 Win 键搜 PowerShell,Mac 按 Command + 空格 搜 终端),把下面命令里的 粘贴你的xAI密钥 换成真密钥按回车测一下:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer 粘贴你的xAI密钥" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.7", "input": "只回复连接正常四个字"}'看到屏幕返回了正常的回答文字,就证明你的账号、余额和网络全都没问题!
第 3 步:打开 DSH,照着表格填好 5 个格子
打开电脑上的 DSH,点击左下角齿轮 Settings -> Models。如果列表里没有内置的 xAI 卡片,直接点击 Add a custom provider(添加自定义服务商),按下面这张表逐格照抄(自定义路由机制见 DSH 官方配置说明 与 适配器源码定义):
| DSH 界面上的格子 | 新手直接填什么 | 注意避坑细节 |
|---|---|---|
Provider ID | xai-grok | 小写英文字母加横杠,创建后不要再改名 |
Display name | xAI Grok | 聊天框里方便你认出来的显示名称 |
Base URL | https://api.x.ai/v1 | 只填到 /v1 为止,千万别在后面多抄 /responses 或 /chat/completions |
API(协议下拉框) | 选 openai-responses(或兼容模式下选 openai-completions) | 官方最新 grok-4.7 Quickstart 默认走 Responses 协议 |
Models(模型 ID) | grok-4.7 | 填你账号在 xAI 模型目录里实际可见的精确英文代号 |
API Key | 粘贴第 1 步复制的 xAI 密钥 | 别混用成 Groq 或 OpenAI 的密钥 |
填好后点击 Save(保存)(更多通用自定义填法可看 DSH 自定义服务商图文指南)。
第 4 步:建个空测试文件夹,验证聊天与读文件
- 在电脑桌面上新建一个空文件夹
dsh-test,回到 DSH 主界面点Choose workspace选中它。 - 点输入框旁边的模型下拉框,选中刚刚配好的
grok-4.7。 - 先发一句普通话:
请用一句话回复连接成功,不要改任何文件。收到正常回话后,再发一句:请列出当前工作区文件夹里的内容,看到界面弹出工具执行卡片并正确汇报“文件夹为空”,就彻底配好了!
(顺带提醒新手区分一件事:你在网上像 DataCamp 的 Grok 4.7 教程 里看到的“Grok 自带搜推特 / 联网搜索”属于 xAI 服务器端专有参数;而在 DSH 里干活时,它主要调用的是 DSH 自己挂载的读本地文件夹、改代码、跑终端命令这套本地工具。)
连不上怎么办?常见报错速查表
| 遇到的报错 | 真正原因 | 一步解决 |
|---|---|---|
报 401 Unauthorized(密码无效) | 不小心把密钥填进了 Groq 卡片,或密钥复制漏了字母 | 删掉错误配置,确认 Base URL 是 https://api.x.ai/v1 并重粘完整密钥 |
报 403 或提示余额不足 | 只开了推特 X 网页会员,xAI 开发后台是 $0 | 登录 console.x.ai 的 Billing 页面单独充入 API 额度 |
报 404 Not Found | Base URL 尾巴上多写了路径,或者模型名拼错了 | 把 Base URL 改成干净的 https://api.x.ai/v1,核对 grok-4.7 拼写 |
| 点自动拉取模型列表失败 | 部分接口权限或网络代理拦截了列表查询 | 不用管自动拉取,直接在 Models 栏手动敲入 grok-4.7 点保存即可(网络超时可查 错误排查中心) |
常见问题
DSH 默认列表里没看到 Grok 图标,是不是不支持它?
完全支持。DSH 专门留了 Add a custom provider 自定义入口,只要按上面第 3 步填好 https://api.x.ai/v1 和协议,用起来跟内置模型没有区别。
我开了 X(原推特)的 SuperGrok / Premium+ 会员,能免费拿来填 DSH 吗?
不能。跟 ChatGPT Plus 一样,网页/App 聊天会员和开发者 API 是两个完全分开的收银台。在 DSH 里用 API Key 必须在 console.x.ai 开发者后台单独充值。
第一次接好之后要注意怎么省钱?
刚开始测试先发短问题、选小文件夹。跑通以后如果要喂几十万字的大代码库,先去 xAI 官方价格表 看清长上下文和缓存计费规则,聊久了顺手敲 /compact 压缩历史对话。
模型与工作流文章
Gemini 4 Neon 发布了,什么活值得交给它?
Gemini 4 Neon 适合什么任务?用一个 CSV 导出 Bug 读懂编程跑分,算清 API 和思考 token 的费用,了解 Pro 与 Ultra 用户怎么打开 Neon。
阅读 →模型与费用GPT-6.2 Astra 与 Sol 指南:价格、评测与选型
零基础读懂 OpenAI 新发布的 GPT-6.2 Astra 与 Sol:对比 Claude 与 DeepSeek 价格、官方评测、27.2 万长文本加价线,附傻瓜式 DSH 与 Python 接入教程。
阅读 →模型与费用GPT-6.1 Terra 使用指南:功能、价格与 Sol 对比
零基础读懂 OpenAI GPT-6.1 Terra:擅长看图识表、屏幕操作与日常办公,价格比 Sol 便宜一半。附横向对比表、费用算例与 DSH / Python 上手教程。
阅读 →模型接入与费用Qwen 3.8 27B 怎么接入 DSH?
手把手教你把本地 Qwen 3.8 27B 接入 DSH:附显卡显存对照表、LM Studio 与 Ollama 端口查看、自定义服务商 5 格填写说明及报错速查。
阅读 →模型接入与费用Codex 费用怎么算?API 与订阅分开看
零基础看懂 OpenAI Codex 收费规则:一张表分清 ChatGPT 会员额度与 API Key 按量计费,对比新老模型单价算例,教你 3 步锁死每月消费上限。
阅读 →模型接入与费用Gemini 怎么选?先看任务和费用
零基础读懂 Google Gemini 选型指南:对比 3.8 Flash、4 Argon 与 DeepSeek 价格和适用场景,注意优惠截止日期,附 DSH 四步接入教程。
阅读 →模型跑分与工程实践Gemini 4 Argon 编程评测:跑分与长输出边界
零基础读懂 Gemini 4 Argon 编程评测:对比 Claude Opus 5.5 与 GPT 跑分强弱项,拆解 100 万共享窗口与 6.5 万默认输出限制,附 DSH 接入教程。
阅读 →API 费用与企业 ROIGemini 4 Argon API 价格:缓存折扣与成本测算
大白话算清 Gemini 4 Argon API 价格:对比 12 月涨价前后与 DeepSeek 账单,讲清 95% 自动缓存生效条件与思考字数扣费,附实时计算器。
阅读 →模型接入与费用Claude Sonnet 与 Opus 怎么选?
大白话对比 Claude Sonnet 5.5 与 Opus 5.5:价格表、每轮真实花费与适用场景一目了然,手把手教你在 DSH 里同时配好两款随时切换。
阅读 →模型与费用Opus 5.5 vs Fable 5.2:谁更适合你的工作?
零基础看懂 Claude Opus 5.5 与 Fable 5.2 怎么选:对比价格、编程跑分、单任务花费与 30 天数据保留限制,附 DSH 分步搭配教程。
阅读 →内容创作DeepSeek Harness 自媒体工作台,怎么把一句灵感变成口播稿?
用 DeepSeek Harness 自媒体工作台 dsh-media-desk,把一句灵感写成口播脚本,再补封面、配图和分镜。附安装命令、生图配置、排期与导出说明。
阅读 →手机端与远程使用DeepSeek Harness 手机端怎么用?新手连接教程
DeepSeek Harness 手机端零基础教程:官方无独立手机安装包,手把手教你查电脑 IP、家庭 Wi-Fi 2 分钟直连、Tailscale 4G/5G 远程连接及微信飞书接入。
阅读 →模型接口与工作流MiniMax H3 能接入 DSH 吗?
零基础搞懂 MiniMax H3 与 M3 在 DSH 里的区别:避开国内站与国际站 401 填反大坑,手把手教你 4 步接入 M3 写代码并配合 H3 视频素材。
阅读 →API 凭据与排错Kimi API Key 报错:区域、模型与权限排查
手把手解决 Kimi / Moonshot API Key 报错:一张表核对国内 .cn 与国际 .ai 地址、kimi-k3 正确模型名及 401/404/429 秒修办法。
阅读 →图片编辑与工具AI 图片编辑:提示词、蒙版与验收
零基础学会 AI 图片编辑不走样:分清看图聊天与真改图工具,直接照抄 4 行锁死主体提示词模板,避开蒙版透明通道坑并安全配合 DSH 处理图片。
阅读 →