xAI Grok

先区分 xAI 原厂能力与本站适配

xAI 围绕 Grok 提供文本推理、工具、视觉、图像、视频和实时语音。直连使用 xAI Bearer API Key；本站使用本站令牌，并只承诺 api_paths 中列出的适配。网页端功能、xAI 新发布的原生端点或模型，不会自动成为本站入口。

新文本集成优先 Responses

xAI 官方把 Responses API 作为推荐接口，并把 Chat Completions 归为 legacy；新工具与状态能力会优先进入 Responses。Responses 返回类型化 output items，可用 previous_response_id 续接；Chat 使用 messages/choices，通常由客户端重发历史。两套响应、工具结果和流式事件不同，迁移不能只替换路径。

明确决定是否存储

Responses 的 store 默认值为 true，响应可在有限保留期内检索或续接。不希望 xAI 持久化响应时设置 store: false，并由应用保存完整上下文；后续普通 HTTP 调用不能假设 previous_response_id 仍可从服务端恢复。ZDR 是团队级策略，且会关闭依赖存储的 Responses 状态、Files、Batch 和部分媒体输出能力，不能把单次 store: false 当作完整 ZDR 承诺。

视频是异步媒体任务

直连 xAI 视频接口先返回 request_id，REST 客户端再轮询状态：pending 是处理中，done、failed、expired 是终态。SDK 可以代为轮询，但仍应配置间隔、总超时与取消。完成后的默认媒体 URL 是临时地址，需要长期保存时应及时下载或使用官方 Files 存储选项。本站当前未把 xAI 原生视频路径列为适配入口，这一流程仅解释原厂行为。

错误、限流、成本与安全

401/403 检查团队、密钥和能力权限，429 降低并发并按响应头退避，参数或审核错误应修正请求，临时 5xx 才有限重试。保存请求 ID、模型、service_tier、用量和工具来源；媒体按秒或按张、文本按 token 计费，具体以当前模型页为准。密钥只放服务端，敏感任务还应核对响应中的 ZDR 标志和团队数据策略。