高级 API 用法
输出水印
支持水印的 Grok 模型会在文本响应中加入不可见的水印,以便 SpaceXSI 日后识别模型生成的文本。无需修改请求或传入参数,无论是否启用水印,现有集成的用法都相同。
为遵守欧盟《人工智能法案》,SpaceXSI 会为文本模型的输出添加水印。所有 SpaceXSI API 端点均启用水印,包括全球端点 https://api.x.ai 和所有区域端点。
水印按模型设置,对整个团队生效。团队管理员可在 SpaceXSI Console 中关闭水印,详见关闭水印。
哪些输出带有水印
对于已为团队启用水印的模型,水印适用于文本生成请求产生的文本。
自 2026 年 11 月 7 日起,以下模型的响应默认带有水印。你可以按模型关闭水印。
grok-4.7
grok-4.6
grok-4.5
grok-4.3
grok-4.20-reasoning
grok-4.20-non-reasoning
grok-4.20-multi-agent
水印适用于所有文本生成 API,包括 Responses API 和 Chat Completions API。响应中生成的文本都在其范围内,包括普通文本、结构化输出以及工具调用参数。
检查响应是否带有水印
要检查响应是否带有水印,请读取 x-watermark 响应头(Responses API 和 Chat Completions API 均支持)。x-watermark: true 表示生成该请求的输出时启用了水印。其他值或没有此响应头均表示未启用。
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, response } = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'Write a haiku about the ocean.',
});
console.log(response.headers?.['x-watermark']);
console.log(text);工作原理
水印不可见。模型在生成文本时会微调选择 token 的方式,因此响应中不会增加任何字符、标记或隐藏文本。
水印检测采用统计方法。SpaceXSI 会根据水印特征给一段文本评分,并报告带有水印、不带水印或无法确定。文本越长,检测信号越强。
关闭水印
团队管理员可在 SpaceXSI Console 中关闭部分或全部模型的水印。设置适用于团队中的所有 API 密钥。
打开团队设置页面,找到 Model output watermarking 一行。它会显示 On (all models)、Off (all models) 或 Custom。仅团队管理员可见此行。
选择旁边的设置图标,取消勾选需要关闭水印的模型。使用 Select all 可一次性启用或关闭所有模型的水印。
选择 Save。如果关闭了某个模型的水印,请选择 Opt Out。
更改会在 5 分钟内对新请求生效。关闭某个模型的水印后,该模型的新请求将不再包含水印。重新启用后,新请求会再次带有水印。
关闭水印时,你需要确认自己的使用情形符合适用法律规定的例外条件,并自行承担标记、披露或其他法定义务的全部责任。
你的团队可能被要求为某些模型始终启用水印。这些模型会显示在对话框中,但无法通过 Console 关闭水印。如有疑问,参见为什么无法关闭某个模型的水印?
每次启用或关闭水印都会记入团队审计日志。团队管理员可以打开审计日志页面,在 SpaceXSI Console 中查看。可按事件 ID、描述或用户搜索变更,并用时间筛选器限制日期范围。有关筛选器的截图,请参阅安全常见问题中的是否提供审计日志?一节。
常见问题
需要修改代码吗?
不需要。水印没有对应的请求参数,响应格式唯一的变化是新增了 x-watermark 响应头。
关闭水印对所有 API 密钥都生效吗?
是的。设置按模型分别指定,适用于团队的每一把 API 密钥。
为什么无法关闭某个模型的水印?
你的团队必须为该模型启用水印。这类模型会出现在水印设置对话框中,但没有复选框。
如对这类模型有疑问,请联系团队管理员。如仍有问题,请发邮件至 support@x.ai。
水印会影响质量或速度吗?
不会。水印不会改变响应的质量或速度。
最后更新:2026 年 10 月 31 日