Add safety_identifier to chat.create (#221)
xAI 的 Python SDK 提交(#221)为 client.chat.create 的同步与异步接口新增 safety_identifier 关键字参数,并透传给 GetCompletionsRequest。该参数由 SDK 使用者设置为分配给终端用户的不透明稳定字符串;当请求违反使用政策时,xAI 将违规归因到该标识符而非整个 API key。文档建议传内部用户 ID 的哈希,不要用邮箱或显示名。旧的 user 参数仍可用,其 docstring 已指向 safety_identifier。API 侧已接受并记录该字段,公开文档仍在编写中。
Development
- First ReportAdd safety_identifier to chat.create (#221)xAI Python SDK Updates
- Current AssessmentAPI 供应商把安全归因标识符做进 SDK 参数,意味着平台侧合规与滥用治理开始要求开发者承担用户级可追溯性。这可能成为企业采购与合规审查中的一项接口要求,但当前证据仅覆盖 xAI 一家,尚不能推断为行业统一做法。Agent Pulse · analysis
xAI 在 xai-sdk-python 仓库提交 #221,为 client.chat.create(同步与异步)增加 safety_identifier 参数并透传到 GetCompletionsRequest。按提交描述,SDK 使用者把该参数设为应用为终端用户分配的不透明稳定字符串;请求违反使用政策时,xAI 将违规归因到该标识符,而不是整个 API key。提交明确建议传内部用户 ID 的哈希,不要传邮箱或显示名。旧 user 参数继续可用,其 docstring 已改为指向 safety_identifier。API 已接受并记录该字段,公开文档仍在进行中。
从接口设计看,这是把滥用归因粒度从 API key 下沉到应用侧用户标识:SDK 只做参数透传,归因逻辑在服务端。可验证的下一信号是公开文档是否给出该字段的格式约束、长度上限与哈希算法建议,以及是否在错误响应中回传该标识符。
API 供应商把安全归因标识符做进 SDK 参数,意味着平台侧合规与滥用治理开始要求开发者承担用户级可追溯性。这可能成为企业采购与合规审查中的一项接口要求,但当前证据仅覆盖 xAI 一家,尚不能推断为行业统一做法。
对使用 xAI API 的产品团队,这意味着需要在请求链路中稳定生成并传递用户级哈希标识,涉及数据最小化与隐私设计;好处是违规归因不再牵连整个 API key,降低单点封禁带来的业务中断风险。
若该字段进入公开文档并被其他供应商跟进,用户级安全标识可能成为聊天补全类 API 的常见参数;反之若长期停留在内部约定,则影响限于 xAI 生态。观察点是公开文档发布与是否出现同类字段的跨厂商对照。