DeepSeekDSH
独立社区指南与 DeepSeek 无隶属关系。下载版本与教程参考

Grok API 怎么接入 DSH?

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

维护:DeepSeekDSH(独立站点)资料整理
本页内容
Grok API 接入 DSH 时核对凭据、协议和模型的示意图

想把马斯克旗下 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.comhttps://api.groq.com/openai/v1DSH 里自带的 Groq 卡片是给它用的,不能填 xAI 的密钥

只要记牢:xAI 的 Grok 密钥绝对不能填进 DSH 内置的 Groq 卡片里,否则 100% 报密码错误!

零基础 4 步实操:把 xAI Grok 接进 DSH

确认你电脑上已经装好并能打开 DSH(还没装可先看 电脑端 5 分钟安装教程),然后按顺序做下面 4 步:

第 1 步:去 xAI 控制台领一把 API Key(密钥)

  1. 在浏览器打开 xAI 官方开发者文档与控制台入口(参考 xAI 官方 Quickstart),注册并登录你的账号。
  2. 先在后台的账单(Billing)页面确认账户里有可用额度(xAI 官方价格表 按实际读写字数扣费;注意你在 X 推特上开通的 Premium 会员费跟这里的 API 余额是分开的,不通用)。
  3. 进入 API Keys 页面新建一把密钥,把弹出来的整串密码立刻复制存进备忘录(千万别把密钥截图发到群里或写进公开代码仓库)。
  4. 顺手在后台的 官方模型目录 看一眼你账号当前开放的模型代号,目前官方示例主力型号是 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 IDxai-grok小写英文字母加横杠,创建后不要再改名
Display namexAI Grok聊天框里方便你认出来的显示名称
Base URLhttps://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 步:建个空测试文件夹,验证聊天与读文件

  1. 在电脑桌面上新建一个空文件夹 dsh-test,回到 DSH 主界面点 Choose workspace 选中它。
  2. 点输入框旁边的模型下拉框,选中刚刚配好的 grok-4.7。
  3. 先发一句普通话:请用一句话回复连接成功,不要改任何文件。收到正常回话后,再发一句:请列出当前工作区文件夹里的内容,看到界面弹出工具执行卡片并正确汇报“文件夹为空”,就彻底配好了!

(顺带提醒新手区分一件事:你在网上像 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 FoundBase 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 费用与企业 ROI

Gemini 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 处理图片。

阅读 →