Grok API 怎么接入 DSH？

Grok 与 Groq 不是同一个接入入口

Grok 使用 xAI 的文档、控制台和 API 凭据。本站的 Groq Provider 教程介绍的是另一家服务，两家的 Key 要分别保存和使用。

xAI 当前 Quickstart 使用 grok-4.7，API 根地址是 https://api.x.ai/v1，示例走 Responses。旧教程里可能仍使用 4.6；写配置时以实际账户可用的模型和当前接口说明为准。官方 Quickstart

先把账号与 API 访问确认下来

在 xAI 控制台检查 API 凭据、团队的模型访问和付款状态。创建 Key 后安全保存，不要把它发进聊天记录、文章评论、截图或公开仓库。

先用官方最小请求确认账户能调用目标模型，第一次连接只保留短文本请求所需的配置。需要扩展图片、资料与验证工具时，再参考 DataCamp 的 Grok 4.7 教程。官方模型目录、网络教程的独立请求示例

不经过 DSH，先完成一个短请求

按官方 Quickstart，固定模型、地址和协议，发送一个无需搜索、文件或执行工具的短问题。确认请求成功并收到文本回复后，再进入 DSH 配置。

如果这个请求失败，先记录服务端返回的具体错误，再检查对应层：凭据是否属于当前团队，模型是否可访问，接口路径是否正确，账户是否遇到了限流或费用限制。错误信息中的具体字段比“我已经买了套餐”更有诊断价值。

如果请求成功，保留非敏感的模型 ID、协议和响应信息。随后在 DSH 中重用这些已确定的条件。不要为了让配置“看起来像别人的截图”又换一个模型名。

Grok 接入 DSH：协议与地址一起核对

先看当前安装版本的 Provider 目录。如果有对应内置项，核对它使用的协议和模型列表；如果没有，再查看自定义模型 API 的设置。

所参考的 DSH 源码支持在自定义路由中选择 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages。官方 Grok Quickstart 的 Responses 示例，不能直接填进另一种协议的路由。DSH 协议实现

填写时逐项检查：

DSH 的模型发现功能是一种便利，不是所有服务都保证提供的能力。若模型发现失败，但独立生成请求正常，先核对目录接口与响应格式；手动添加已确认的 ID 可能比反复换 Key 更合理。官方配置指南

保存后，再验证 DSH 的实际任务

使用新会话选中目标模型，先让它回复一段普通文本。再在隔离工作区尝试一个只读工具，例如列出目录文件。验收需要看到工具被调用、结果返回，并被后续回复正确使用。

同时要分清两种工具：xAI 提供的服务端工具，与 DSH 挂载的工作区工具不是同一套配置。某篇 Python 教程调用了网页搜索或代码执行，不代表 DSH 经由该路由也自动拥有这些能力。

DataCamp 的 4.7 案例值得借鉴的是“先定义验收，再检查结果”。但它是作者的 Python 电路审查工程，不是本站的 DSH 接入记录，相关依赖与工具调用不能直接移植。教程的验证方法

费用与长请求，最后再优化

文本调用跑通后，再考虑上下文、缓存、速度和工具费用。xAI 的价格表按模型与请求条件列价，长上下文和其他服务项需要另外核对。只抄模型首页的一对输入/输出价格，可能漏掉自己的调用条件。官方 API 价格

新手不必为了第一次连接就追求最长上下文。先让任务小到可以快速检查，再逐步扩大范围，出错时也能保留一份清楚的请求记录。

常见问题

DSH 里没有 Grok 卡片，是否说明不能接入？

不能仅据此判断。内置目录取决于安装版本；是否能用自定义路由，还需要核对协议、模型与实际请求。本文没有替你的安装环境验证这一步。

官方 Python 示例能用，为什么 DSH 仍失败？

它们可能用了不同协议、模型、请求字段或工具声明。先保持同一组条件，按层比较，不要一次改动所有设置。

Grok 的网页搜索会自动变成 DSH 的工具吗？

不会因为配置了一条模型路由就能作此推断。分别确认服务端工具与 DSH 的插件、权限和适配器支持。

下一步：完成一个小任务

Grok API 接入 DSH 的验收，不是保存按钮没有报错，而是目标模型确实完成了可检查的任务。需要填写路由时，继续看自定义 Provider 指南；出现启动或模型错误时，从错误中心查对应信息。

模型接入、选型与费用指南