# ttgg / ttqq Grok 模型用法

其他项目接 `https://ttqq.inping.com` 或直连 `https://ttgg.inping.com` 时，按模型名选轨。客户端不要再传一套「方案」参数。线上说明页：<https://ttgg.inping.com/playbook/api.html>。

日期：2026-09-30。

## 怎么选

| 用途 | model | 上下文 | 工具 | 长任务 |
|---|---|---|---|---|
| 聊天、短问答 | `grok-latest`、`grok-chat-fast`、`grok-4.20-fast`、`grok-4.3-fast`、`grok-4.20-0309-non-reasoning` | 131072 | 不稳定。网关把工具说明写进正文 | 否。超窗返回 400 |
| 开发、函数调用、长任务 | 裸版本号 `grok-4.5` 及以上，含以后的 `grok-4.*` / `grok-5.*`。现在常用 `grok-4.7`、`grok-4.6` | 500000 | 可以。`tools` 交给 cli-chat-proxy | 可以。用 `stream: true` |
| 出图 | `grok-imagine-image`、`grok-imagine-image-lite` | 不是聊天窗口 | 不适用 | 不适用 |

难的编码任务把 Build 模型写成 `grok-4.6-high` 或 `grok-4.7-xhigh`。后缀不会原样送给上游：`grok-4.6-high` 发出去是 `model=grok-4.6` 加上 `reasoning_effort=high`。`grok-4.6` 不写后缀时，网关补 `reasoning_effort=low`。

## 两条轨

Web 打 grok.com 网页对话，请求体是消息加 `modeId=fast`，没有 OpenAI 的 `model` 字段。上面聊天那一组名字都收成同一种 fast。

Build 打 `cli-chat-proxy.grok.com`。`/v1/responses` 与 `/v1/chat/completions` 在 `is_build_chat()` 为真时都进这条轨。裸 id `grok-主版本.次版本` 从 4.5 起自动是 Build，不必等目录里先有这一行，也不必再手写 `grok-4.8`、`grok-5.0`。带日期或 `-fast` 的名字仍是 Web。同一登录可以两轨都用，额度和凭证分开。

## 接口

`base_url` 用网关或直连都可以。请求头 `Authorization: Bearer <密钥>`。

- 经 ttqq：`https://ttqq.inping.com/v1/chat/completions`
- 直连 ttgg：`https://ttgg.inping.com/v1/chat/completions`
- 模型列表：`GET /v1/models`
- Build 的 Responses：`POST /v1/responses`
- 出图：`POST /v1/images/generations`

ttqq 上这些 Grok 名字的说明标签已经按轨写好：Web 是 `Web,Chat,128K`，Build 是 `Build,Tools,500K`。上下文数字以 `/v1/models` 里的 `context_length` 为准。

## 不要这样调

- 不要把 Web 模型用于要稳定 `tool_calls` 的代理。
- 不要写裸名 `grok-4.3`、`grok-build-0.1`、`composer-2.5`、`grok-composer-2.5-fast`。公开聊天目录里没有它们。
- 不要用 `grok-4.20-heavy`、`grok-4.3-heavy`，除非 heavy 号池里有可用账号。当前没有。
- `grok-4.20-0309-non-reasoning-console` 这个名字仍是 Web fast，不是另一条 Console 轨。

## ttqq 上还留着的两个别名

这两个不是 Grok 本名，调用前要知道它们落到哪条轨：

| 对外名字 | 实际发到 ttgg 的模型 | 轨 |
|---|---|---|
| `gpt-5.5` | `grok-4.20-0309-non-reasoning` | Web，128K |
| `gpt-6-astra` | `grok-4.7-xhigh` | Build，500K |

新项目请直接写上表里的 Grok 名，不要靠这两个别名猜能力。