接口参考

对话补全

通过标准文本消息创建对话响应。

请求格式

POST /v1/chat/completions

curl https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer $NXAG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "demo-chat",
    "messages": [{"role": "user", "content": "你好"}]
  }'

请求参数

参数	约束 / 行为
`model`	必填，来自模型列表的 ID
`messages`	1–50 条消息；role 为 system/user/assistant；content 为字符串，每条最多 20000 字符
`stream`	默认 false；true 返回 text/event-stream
`temperature`	可选，0–2；演示模式不使用该参数
`max_tokens`	默认 1024，范围 1–4096；演示模式按字符近似截断
`stream_options`	可选，include_usage: true 输出末尾用量事件

整个请求正文不能超过 64 KB。只支持上述参数，未知字段返回 400。真实上游请求超时为 90 秒。

流式输出

data: {"choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

SSE 传输开始后，HTTP 状态已经发送。客户端必须检查事件中的 error，并确认收到 [DONE]。取消生成会停止读取上游；已消耗的上游资源不一定能退回。