请输入
菜单

Chat Completions 对话

使用 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]。

最近修改: 2026-10-28