对话接口 Chat Completions
兼容 OpenAI 的对话补全接口说明。
基本信息
| 项目 | 说明 |
|---|---|
| 请求地址 | POST /v1/chat/completions |
| 认证方式 | Authorization: Bearer <API_KEY> |
| 请求格式 | JSON |
| 限流 | 默认 60 次/分钟 |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称 |
| messages | array | 是 | 对话消息列表 |
| temperature | number | 否 | 采样温度 0-2 |
| max_tokens | integer | 否 | 最大生成长度 |
| stream | boolean | 否 | 是否流式返回 |
请求示例
bash
curl -X POST {api_base_url}/v1/chat/completions
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d "{
"model": "deepseek-v3",
"messages": [{"role": "user", "content": "你好"}]
}"响应字段
id：请求唯一标识model：实际使用的模型choices：生成结果数组usage：Token 消耗统计
流式接口请将
stream 设为 true，通过 SSE 逐字返回，首字延迟更低。