接口端点:POST /v1/chat/completions身份认证:Authorization: Bearer 您的API_KEY
核心参数说明表
在发送 POST 请求时,请提供以下参数:| 参数名称 | 是否必填 | 参数说明 |
|---|---|---|
| model | 必填 | 模型 ID,例如 qwen-plus。请从模型广场或 /v1/models 获取当前可用值。 |
| messages | 必填 | 对话的历史记录与当前问题。它是一个列表,每条记录需要包含“角色(role)”和“内容(content)”。角色可以是 system(系统设定)、user(用户提问) 或 assistant(AI 回答)。 |
| temperature | 选填 | 采样温度。较低数值通常更稳定,支持范围和默认值由所选模型决定。 |
| stream | 选填 | 是否启用流式输出(打字机效果)。设置为 true 时,数据将逐步推送到您的客户端。 |
| max_tokens | 选填 | 限制本次回答的最大 Token 数,防止输出过长。 |
| tools | 选填 | 外部工具/函数调用列表。如果您希望 AI 能够调用您自己开发的外部插件(如查天气),可在此定义。 |
| reasoning_effort | 选填 | 推理强度。仅在所选模型支持时生效,常见值为 low、medium 或 high。 |