指南
指纹
对于对 xAI API 的每个请求，响应正文将包含一个唯一的system_fingerprint价值。此指纹用作后端系统配置当前状态的标识符。
例：
bash
curl https://api.x.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-d '{
"messages": [
{
"role": "system",
"content": "You are Grok, a chatbot inspired by the Hitchhikers Guide to the Galaxy."
},
{
"role": "user",
"content": "What is the meaning of life, the universe, and everything?"
}
],
"model": "grok-2-latest",
"stream": false,
"temperature": 0
}'
响应：
json
{..., "system_fingerprint":"fp_6ca29cf396"}
您可以自动化系统以跟踪system_fingerprint以及令牌消耗和其他指标。
指纹的使用
- 监控系统更改：系统指纹充当后端配置的版本控制。如果后端系统的任何部分（例如模型参数、服务器设置，甚至底层基础设施）发生变化，指纹也会发生变化。这允许开发人员跟踪系统何时以及如何随时间演变。这对于调试、性能优化和确保 API 响应的一致性至关重要。
- 安全性和完整性：指纹可用于确保响应的完整性。如果响应的指纹与基于最近系统配置的预期指纹匹配，则有助于验证数据在传输过程中是否未被篡改或服务是否未受损。指纹会随着时间的推移而变化，这是意料之中的。
- 合规性和审计：对于受监管的环境，此指纹可以作为审计跟踪的一部分，显示何时出于合规性目的使用特定配置。