聊天

文本输入，文本输出。聊天是 xAI API 最受欢迎的功能，可用于从文章摘要、创意写作、回答问题、提供客户支持到协助编码任务等各种用途。

先决条件

• xAI 账户：您需要一个 xAI 账户才能访问 API。
• API 密钥：确保您的 API 密钥有权访问聊天端点，并且已启用聊天模型。

如果您没有这些，并且不确定如何创建，请参阅Grok 搭车人指南。

您可以在xAI 控制台 API 密钥页面上创建 API 密钥。

在您的环境中设置 API 密钥

一个基本的聊天补全示例

您还可以流式传输响应，这在流式响应中有所介绍。

用户向 xAI API 端点发送请求。API 处理此请求并返回完整的响应。

响应

对话

xAI API 是无状态的，不会在您之前的请求历史记录的上下文中处理新请求。

但是，您可以向新的聊天生成请求提供以前的聊天生成提示和结果，以使模型在考虑上下文的情况下处理您的新请求。

消息示例

通过指定角色，您可以改变模型处理内容的方式。system角色的内容应以指令性语气定义模型应如何响应用户请求。user角色的内容通常用于用户请求或发送给模型的数据。assistant角色的内容通常在模型的响应中，或者当在提示中发送时，表示模型的响应是对话历史的一部分。

消息角色顺序的灵活性

与某些其他提供商的模型不同，xAI API 的独特之处之一在于其消息角色排序的灵活性

• 无顺序限制：您可以在对话上下文中以任何顺序混合system、user或assistant角色。

示例 1 - 多个系统消息

示例 2 - 用户消息优先