API参考
对话补全接口
POST /v1/chat/completions 的请求参数、消息结构、请求示例和成功响应。
POST /v1/chat/completions 的请求参数、消息结构、请求示例和成功响应。
给定一组对话消息，模型返回一个对话补全。接口支持普通响应、流式输出以及模型具备能力时的工具调用。
POST/v1/chat/completions
请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer YOUR_APIQIK_API_KEY |
Content-Type | 是 | 固定为 application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型标识，例如 glm-5.1 或 deepseek-v4-flash。 |
messages | array | 是 | 按时间顺序排列的消息列表。 |
temperature | number | 否 | 控制随机性；具体支持范围取决于模型。 |
max_tokens | integer | 否 | 本次最多生成的 Token 数，同时受上下文窗口限制。 |
stream | boolean | 否 | 设为 true 时返回流式增量数据。 |
stop | string 或 array | 否 | 命中指定文本时停止生成；是否支持取决于模型。 |
tools | array | 否 | 提供模型可以调用的工具定义。 |
tool_choice | string 或 object | 否 | 控制是否以及如何选择工具。 |
response_format | object | 否 | 请求 JSON 等结构化格式；需目标模型支持。 |
消息参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
role | string | 是 | 常用值：system、user、assistant、tool。 |
content | string 或 array | 视角色而定 | 文本消息通常为字符串；多模态内容取决于模型支持。 |
tool_calls | array | 否 | 助手请求应用执行的工具调用。 |
tool_call_id | string | 工具消息必填 | 关联产生该结果的工具调用 ID。 |
请求示例
{
"model": "glm-5.1",
"messages": [
{
"role": "system",
"content": "你是一名简洁、可靠的中文助手。"
},
{
"role": "user",
"content": "请解释什么是 API 智能路由。"
}
],
"temperature": 0.7,
"max_tokens": 512,
"stream": false
}成功响应
{
"id": "chatcmpl-apiqik-7f3a2c9e",
"object": "chat.completion",
"created": 1789987200,
"model": "glm-5.1",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "API 智能路由会根据节点状态自动选择合适的推理路径。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 24,
"completion_tokens": 27,
"total_tokens": 51
}
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 本次生成的唯一标识；排查问题时建议保留。 |
object | string | 非流式响应通常为 chat.completion。 |
created | integer | 创建时间的 Unix 时间戳。 |
model | string | 响应对应的模型标识。 |
choices | array | 候选结果列表；常规请求读取第一项。 |
choices[].message | object | 助手消息，可能包含文本或工具调用。 |
finish_reason | string 或 null | 停止原因，例如 stop、length、tool_calls。 |
usage | object | 输入、输出及总 Token 用量。 |