AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
各厂商字段特性差异

Grok 参数与协议差异

了解 Grok 系列模型在兼容协议下的参数差异与使用方式。

使用 Grok 模型时，根据本页调整思考、采样和缓存配置。完整请求与响应结构参阅 Chat Completions 和 Responses。

适用模型

模型使用要点
grok-4.7支持 low/medium/high/xhigh，默认 high，不能关闭思考；Responses 默认返回加密思考
grok-4.6同样支持四档思考，默认 high，不能关闭；需要加密思考时通过 include 请求
grok-4.5支持 low/medium/high，默认 high，不能关闭；传入 xhigh 时按 high 处理

xAI 将 Chat 定位为旧版兼容入口，Responses 为主要接口；历史 Messages 兼容已被官方弃用。本页集中说明 Chat 与 Responses，不表示平台已停用其他兼容入口。

Chat Completions 差异

字段差异说明
reasoning_effort按上表选择档位；不能使用 none 关闭思考
temperature请求允许 0～2，实际采样最高为 1；高于 1 的合法值按 1 处理，不是字段弃用
top_p合法值最高可传 1，实际采样不超过模型默认值，当前为 0.95；省略时使用模型默认值
presence_penalty/frequency_penalty/stop本页思考模型不支持，传入会返回错误；不要直接套用通用 Reference 的这些可选字段
logprobs/top_logprobs本页三款不支持，传入会被静默忽略，与上方返回错误的行为不同
tools[].function.strict工具参数始终严格遵循支持的 JSON Schema，strict 隐式为 true；不能依赖 false 切换为非严格生成
思考历史Chat 不提供 Responses 的加密思考承载字段；需要跨轮回传加密思考时使用 Responses

Responses 差异

字段差异说明
reasoning.effort使用本页对应型号的思考档位，默认 high；不能关闭思考
temperature/top_p适用上方相同的采样上限。响应可能回显原始请求值，不代表实际采用了高于上限的采样值
惩罚与 Logprobs与 Chat 的限制相同：惩罚参数不支持，Logprobs 参数被忽略；不要因改用 Responses 而重新添加
max_output_tokens仅限制可见回答，不计入思考和函数调用 Token；省略时默认 128000，不能按 OpenAI 的合并预算含义理解
includegrok-4.6、grok-4.5 通过 reasoning.encrypted_content 请求加密思考；grok-4.7 无需显式请求也会返回
store/previous_response_idstore 默认 true，原厂响应保存 30 天，可通过 ID 延续。使用 store: false 时，手动回传完整历史及所有输出项目，不只保留最终文本；加密思考须原样保留
tools[].strict函数工具同样采用隐式严格模式；函数参数与结构化输出均按 xAI 支持的 JSON Schema 子集填写
JSON SchemaadditionalProperties 默认 false，需要额外属性时显式设为 true；$ref/$defs 仅支持非循环引用，不能直接照搬递归 Schema
服务端工具xAI Responses 使用 web_search、x_search 和 code_interpreter 等类型；后者对应原生 xAI SDK 的 code_execution，不要混用两套名称

缓存差异

字段差异说明
自动前缀缓存相同输入前缀自动复用；静态指令放在前面，后续只追加内容，不删改或重排历史
x-grok-conv-idChat 请求头中的稳定会话标识，用于尽量将同一会话路由到持有缓存的服务器；不是模型参数
prompt_cache_keyResponses 请求体中的对应会话标识；保持每轮一致，并原样回传加密思考，不添加其他厂商的 TTL 或显式断点配置
缓存用量Chat 查看 usage.prompt_tokens_details.cached_tokens，Responses 查看 usage.input_tokens_details.cached_tokens；缓存可能被清除，设置会话标识不保证命中

媒体输入差异

输入协议内容块差异说明
图片image_urlChat 的 image_url.url 接受公网 URL 或 Base64 Data URL；图片格式为 JPEG／PNG，单图最大 20 MiB
图片input_imageResponses 的 image_url 直接填写公网 URL 或 Base64 Data URL，限制同上；不要套用 Chat 的嵌套对象

三款均输出文本。detail 可使用 auto/low/high 控制图片处理精度，不是图像生成参数。

调用示例

将 MODEL_ID 替换为平台提供的完整模型 ID，并为每个会话设置稳定标识。Responses 示例采用手动历史管理；后续轮次需回传完整输出及加密思考。

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  -H 'x-grok-conv-id: YOUR_CONVERSATION_ID' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "用三点说明如何排查接口超时"}],
    "reasoning_effort": "high",
    "max_tokens": 4096
  }'

官方参考

Gemini

了解 Gemini 系列模型在兼容协议下的参数差异与使用方式。

Muse

了解 Muse 系列模型在兼容协议下的参数差异与使用方式。

本页目录

适用模型Chat Completions 差异Responses 差异缓存差异媒体输入差异调用示例官方参考