聊天补全接口参数说明

本文档描述了聊天补全接口的请求参数，用于生成对话模型的响应。

接口信息

• 请求方式: POST
• 请求路径: /v1/chat/completions
• Base URL: https://api.uk72.cn

认证方式

Authorization: Bearer <APIKey>

基本参数

参数	类型	必填	说明
model	string	是	模型名称，如 deepseek-v3
messages	array	是	消息列表
stream	boolean	否	是否启用流式响应，默认 false

消息格式

字段	类型	说明
role	string	角色：system、user、assistant、tool
content	string	消息内容
name	string	可选，发送者名称
tool_calls	array	工具调用列表（assistant 角色）
tool_call_id	string	工具调用 ID（tool 角色）

生成控制参数

参数	类型	默认值	说明
max_tokens	integer	-	最大生成 token 数
temperature	number	1.0	采样温度（0~2）
top_p	number	1.0	核采样参数
top_k	integer	-	Top-K 采样
presence_penalty	number	0	存在惩罚（-2~2）
frequency_penalty	number	0	频率惩罚（-2~2）
repetition_penalty	number	1.0	重复惩罚

工具调用参数

参数	类型	说明
tools	array	工具定义列表
tool_choice	string/object	工具选择策略：none、auto、required

思维链参数

参数	类型	说明
thinking	boolean	是否启用思维链
reasoning_effort	string	推理深度控制

请求示例

基础对话

curl -X POST "https://api.uk72.cn/v1/chat/completions" \
  -H "Authorization: Bearer sk-xx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

流式响应

curl -X POST "https://api.uk72.cn/v1/chat/completions" \
  -H "Authorization: Bearer sk-xx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "stream": true
  }'

参数最佳实践

• 创造性任务: temperature 0.7-0.9
• 事实性回答: temperature 0.1-0.3
• 代码生成: temperature 0.1-0.3
• 减少重复: repetition_penalty 1.1-1.2
• 对话场景: max_tokens 500-1000

错误处理

状态码	说明
400	参数验证失败
401	认证失败
429	速率限制
500	服务器内部错误