xAI

1. 概述

xAI 是由埃隆·马斯克于 2023 年创立的人工智能公司。主要的旗舰产品是 Grok，一款大型语言模型，具备强大的自然语言处理和生成能力。

模型列表：

• grok-beta

• grok-vision-beta

• grok-2-1212

• grok-2-vision-1212

说明：

1. 本 API 与 OpenAI 接口格式兼容。

2. 请求说明

• 请求方法:POST

• 请求地址:

  https://gateway.theturbo.ai/v1/chat/completions

---

3. 请求参数

3.1 Header 参数

参数名称	类型	必填	说明	示例值
Content-Type	string	是	设置请求头类型，必须为 application/json	application/json
Accept	string	是	设置响应类型，建议统一为 application/json	application/json
Authorization	string	是	身份验证所需的 API_KEY，格式 Bearer $YOUR_API_KEY	Bearer $YOUR_API_KEY

---

3.2 Body 参数 (application/json)

参数名称	类型	必填	说明	示例
model	string	是	要使用的模型 ID。详见概述列出的可用版本，如 grok-beta。	grok-beta
messages	array	是	聊天消息列表，格式与 OpenAI 兼容。数组中的每个对象包含 role(角色) 与 content(内容)。	[{"role": "user","content": "你好"}]
role	string	否	消息角色，可选值：system、user、assistant。	user
content	string	否	消息的具体内容。	你好，请给我讲个笑话。
temperature	integer	否	采样温度，取值 0～2。数值越大，输出越随机；数值越小，输出越集中和确定。	0.7
top_p	integer	否	另一种调节采样分布的方式，取值 0～1。和 temperature 通常二选一设置。	0.9
n	integer	否	为每条输入消息生成多少条回复。	1
stream	boolean	否	是否开启流式输出。设置为 true 时，返回类似 ChatGPT 的流式数据。	false
stop	string	否	最多可指定 4 个字符串，一旦生成的内容出现这几个字符串之一，就停止生成更多 tokens。	"\n"
max_tokens	integer	否	单次回复可生成的最大 token 数量，受模型上下文长度限制。	1024
presence_penalty	number	否	-2.0 ~ 2.0。正值会鼓励模型输出更多新话题，负值会降低输出新话题的概率。	0
frequency_penalty	number	否	-2.0 ~ 2.0。正值会降低模型重复字句的频率，负值会提高重复字句出现的概率。	0
logit_bias	null	否	调整对特定 Token 的生成概率，可提供一个 JSON 对象，映射“Token ID -> 偏差值( -100~100 )”。	null
user	string	否	用户唯一标识，用于监控和检测滥用。	user_123456

---

4. 请求示例

POST /v1/chat/completions
Content-Type: application/json
Accept: application/json
Authorization: Bearer $YOUR_API_KEY

{
	"model": "grok-beta",
	"messages": [
		{
			"role": "user",
			"content": "你好，给我科普一下量子力学吧"
		}
	],
	"temperature": 0.7,
	"max_tokens": 1024
}

5. 响应示例

{
	"id": "chatcmpl-1234567890",
	"object": "chat.completion",
	"created": 1699999999,
	"model": "grok-beta",
	"choices": [
		{
			"message": {
				"role": "assistant",
				"content": "量子力学是研究微观世界的物理学分支……"
			},
			"finish_reason": "stop"
		}
	],
	"usage": {
		"prompt_tokens": 10,
		"completion_tokens": 30,
		"total_tokens": 40
	}
}