/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)」能力已下線,傳入會返回參數值非法。