/api/ai/BuiltInModel/chat
累计调用 5 次
AI 对话(统一入口)
用 model 选择模型发起对话:支持单条消息、完整消息列表、系统提示词覆盖、图片理解与流式输出。
选填:不传则使用平台默认模型;候选清单来自平台(见「模型清单」接口)
选填:发起简单单轮对话时的消息内容(与 messages 至少提供一个)
选填:多轮对话用,格式为 JSON 数组,role 取 user/assistant;优先级高于 content
选填:临时覆盖平台设定;不传=用平台按模型配置的提示词;空字符串=不使用系统提示词
选填:仅「支持视觉」的模型可传;JSON 数组或纯文本(换行/逗号分隔)的公网图片地址,张数上限由平台按模型配置(后台可调)
选填:传了就用调用方自己的 Key(须与所选模型所属厂商一致),不传则用平台密钥
选填:true 时响应为 SSE(text/event-stream),逐块推送
- 请求体为 application/x-www-form-urlencoded 表单;本服务需项目签名。
- content 与 messages 至少提供一个,否则返回参数缺失。
- images 仅对「支持视觉」的模型有效,其它模型传了返回参数值非法(20003);张数上限由平台按模型配置(后台可调),超限同样返回参数值非法。
- 采样温度 / 最大回复长度 / 停止词由平台按模型统一配置,不接受调用方传入,传了会返回参数值非法(20003)。
- 流式模式返回 SSE:每帧形如 data: {"content": "片段"}(答案正文)或 data: {"reasoning": "片段"}(推理模型的思考过程,仅这类模型有,与答案分开下发、只关心答案可忽略),结束标记 data: [DONE];在线调试会把答案正文按 Markdown 渲染排版并逐字打印,推理模型的思考过程收进可折叠的「思考过程」(首屏自动展开,开始出答案后自动收起)。
- 在线调用会真实消耗上游额度,请确认平台密钥可用后再调试。
- 原「前缀续写(prefix / prefix_content)」能力已下线,传入会返回参数值非法。