Grok Build
TIP
api_backend = "responses" 时说的是 Responses 协议,KIE 的 Grok 模型正是按这个协议提供的。Grok Build 通过 config.toml 里的 [model.*] 表连过来。重要规则
1.
GET https://api.kie.ai/xai/v1/models 发现模型,不要凭记忆或训练数据写模型名。 这个接口给出的才是 Grok Build 在这个前缀上能跑的那份列表。通用的 taskType=Chat 目录是另一份更宽的列表:里面有这个接口并不提供的模型。2.
Authorization: Bearer 认证。 KIE 的所有接口都靠这一个请求头携带 API key,列模型接口也一样。名字就叫 apikey 的请求头会被 401 拒掉。3.
api_backend = "responses"。 Grok Build 的默认后端是 chat_completions,会往 /v1/chat/completions 发。KIE 在 /xai/v1/responses 上提供这些模型。4.
model 字段要填 listing 里的 id。 这才是发给 KIE 的名字,既不是表名 [model.<name>],也不是 Grok Build 自带的拼法(例如 grok-4.6)。listing 用的是另一套 id(例如 grok-4-6)。照抄列表里的 id;填自带名字时,就算 base_url 对了 KIE 也会拒。5.
.grok/config.toml 只贡献 MCP、插件和权限相关键,写在那里的 [model.*] 不是推理配置。列出可用模型
curl.exe 发同样的请求:curl.exe -s -H "Authorization: Bearer $env:KIE_API_KEY" `
https://api.kie.ai/xai/v1/models | jq -r '.data[].id'.data[] 就是列表:id 是填进 model 的值。object、owned_by、created、aliases 是样板字段。写配置
[model.<name>] 表配自定义模型。<name> 是选择器里的键,model 是发给 KIE 的 id:[models]
default = "kie"
[model.kie]
model = "grok-4-6"
base_url = "https://api.kie.ai/xai/v1"
name = "KIE"
api_backend = "responses"
env_key = "KIE_API_KEY"base_url 是发请求的根路径,api_backend = "responses" 时 Grok Build 会自己往后面拼 /responses,所以这里配的是 https://api.kie.ai/xai/v1,不是完整的请求 URL https://api.kie.ai/xai/v1/responses。env_key 指的是 Grok Build 从哪个环境变量里读凭证 并作为 bearer token 发出去,它本身不存放密钥。优先用它,不要把密钥写进 api_key。kie——由你自己取。[models] default 必须是这个键(或另一个 [model.*] 的键),不能是 Grok 内置目录里的名字,否则新会话仍会打到 xAI 而不是 KIE。macOS 与 Linux
~/.grok/config.toml。在启动 grok 的同一个 shell 里导出凭证,或者写进 shell profile:GROK_HOME 可以把配置放到 ~/.grok 以外的地方。Windows(PowerShell)
%USERPROFILE%\.grok\config.toml,内容完全一致。$env:KIE_API_KEY = "…"
setx KIE_API_KEY "…"确认配置生效
grok models 应列出这个自定义键。grok inspect 会报告哪份配置文件生效。在设好 KIE_API_KEY 的 shell 里启动 grok 发一条消息,或 grok -p "…" -m kie。RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok 会写下请求轨迹。看 base_url 和模型 id。常见坑
1.
apikey 的请求头。 KIE 会返回 401。key 要放进 Authorization: Bearer。2.
base_url。 api_backend = "responses" 时 Grok Build 自己会拼 /responses,所以 base_url 以 /responses 结尾会拼成 /responses/responses。3.
api_backend。 默认是 chat_completions,会往 /v1/chat/completions 发,不是 /xai/v1/responses。4.
model。 KIE 读的是 [model.<name>] 里的 model 字段,必须是 listing 的 id。自带拼法例如 grok-4.6 不是那个 id。5.
[model.*] 写进了项目级 .grok/config.toml。 那个文件不承载推理配置。用 ~/.grok/config.toml。6.
env_key。 它填的是环境变量名,密钥本身在那个变量里,不在配置文件里。7.
setx 不影响当前窗口。 它对此后新开的窗口生效。想立刻用上,同时设 $env:。8.
curl。 它是 Invoke-WebRequest 的别名,不接受这些参数。用 curl.exe。