模型名称#
| 字段 | 值 |
|---|
| 模型名称 | grok-4 |
| 接口类型 | OpenAI 兼容 Chat Completions API |
对话 API#
请求地址#
POST https://yesapi.online/v1/chat/completions请求参数#
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
model | string | 是 | - | 固定值：grok-4 |
messages | array | 是 | - | 对话消息数组，包含 system、user、assistant 等角色 |
max_tokens | integer | 否 | - | 最大输出 token 数 |
temperature | number | 否 | 1 | 控制输出随机性，数值越低越稳定 |
top_p | number | 否 | 1 | 核采样参数 |
stream | boolean | 否 | false | 是否启用 SSE 流式输出 |
tools | array | 否 | - | 工具调用定义，适用于函数调用和 Agent 场景 |
请求示例#
流式输出#
将 stream 设置为 true 后，接口会以 SSE 方式持续返回增量内容，适合聊天窗口、代码生成和长文本输出。响应示例#
{
"id": "chatcmpl_example",
"object": "chat.completion",
"model": "grok-4",
"choices": [
{
"index": 0,
"message": {"role": "assistant", "content": "可以通过 Base URL、API Key 和模型名称完成接入。"},
"finish_reason": "stop"
}
],
"usage": {"prompt_tokens": 32, "completion_tokens": 24, "total_tokens": 56}
}
响应字段#
| 字段 | 类型 | 说明 |
|---|
id | string | 请求 ID |
choices[] | array | 模型输出列表 |
choices[].message.content | string | 非流式响应文本 |
choices[].delta.content | string | 流式响应增量文本 |
usage | object | token 用量统计 |
Python SDK 示例#
Node.js SDK 示例#
错误码#
| 状态码 | 类型 | 排查建议 |
|---|
400 | 请求参数错误 | 检查 model、messages、max_tokens 等字段 |
401 | 鉴权失败 | 检查 API Key 和 Authorization Header |
402 | 余额不足 | 检查账户余额或套餐额度 |
429 | 请求过快 | 降低并发或增加重试间隔 |
500 | 服务异常 | 记录请求 ID 后重试或联系支持 |
最佳实践#
对成本敏感的场景可结合模型广场选择更高性价比模型。
相关链接#
Modified at 2026-07-21 14:39:36
