使用 messages 消息列表生成回复,支持普通 JSON 响应和 SSE 流式响应。
请求
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 路径 | /v1/chat/completions |
| 网关地址 | https://ailink.nativex.com |
| 认证 | Authorization: Bearer sk-xxxx,替换为你的 API Key |
| 请求格式 | application/json |
示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。
参数说明
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
model |
Body | string | 是 | 支持对话的模型 |
messages |
Body | object[] | 是 | 消息数组;常用角色为 system、user、assistant |
stream |
Body | boolean | 否 | true 开启 SSE;默认 false |
temperature |
Body | number | 否 | 传统 OpenAI 格式为 0~2;部分推理模型不支持自定义 |
top_p |
Body | number | 否 | 核采样参数,传统范围 0~1 |
max_completion_tokens |
Body | integer | 否 | 输出 token 上限,需为模型支持的正整数 |
max_tokens |
Body | integer | 否 | 传统输出上限参数;不要与 max_completion_tokens 同时设置 |
tools |
Body | object[] | 否 | 工具定义;需要模型支持 |
tool_choice |
Body | string / object | 否 | 工具选择策略 |
response_format |
Body | object | 否 | 输出结构,如 JSON 格式;需模型支持 |
多轮对话需要按顺序传入历史消息。参数范围受具体模型约束,不能仅凭接口兼容性判断全部参数都可用。
调用示例
curl -X POST 'https://ailink.nativex.com/v1/chat/completions' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "请用一句话介绍自己。"
}
],
"stream": false
}'
响应
以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。
{
"id": "chatcmpl_example",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!有什么可以帮助你?"
},
"finish_reason": "stop"
}
]
}
| 字段或结果 | 说明 |
|---|---|
| choices[].message | 完整回复及可能的工具调用 |
| choices[].finish_reason | 结束原因 |
| usage | 模型返回的用量信息 |
错误处理
非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。
流式调用
将 stream 改为 true,并为 curl 添加 -N。读取每个 data: 事件中的 choices[].delta;不能将整个流当成单个 JSON。常见结束标记为 data: [DONE]。