AI 服務

多模型 AI 對話接口:用 model 參數在多家廠商的模型間切換,單輪 / 多輪、流式、圖片理解(部分模型)一應俱全。

/api/ai/

服務說明

AI 服務提供開箱即用的對話能力,已接入多家廠商的模型(當前含 DeepSeek);平臺側統一持有各廠商密鑰,調用方無需自行申請與配置,適合做內容生成、摘要、問答等功能的快速驗證。

切換模型只需改 model 一個參數,接口地址、鑑權方式與響應結構完全不變:候選模型見下方「模型清單」接口,或直接看 chat 端點的 model 下拉。新增模型由超管在後臺添加,對大模型廠商的差異(上遊地址、密鑰、能力)全部在服務端收口。

同一個接口覆蓋單輪與多輪對話:傳 content 發起簡單單輪問答,傳 messages(JSON 數組,含 role 與 content)則進行多輪對話;同時支持流式輸出。

系統提示詞由平臺按模型統一配置(超管在後臺維護,可設多套並指定某個模型用哪一套),調用方不需要、也不能改生成策略——採樣溫度、最大回復長度、停止詞同樣由平臺控制,接口不接受這些參數,從而保證所有接入方拿到的行為一致、可控。

標記了「支持視覺」的模型可以額外傳 images(公網圖片地址)讓它看圖回答;未標記的模型傳圖片會返回參數值非法,避免把參數靜默丟掉。

本服務需項目簽名。開啟流式(stream=true)後返回的是逐段推送的 SSE 內容,與普通 JSON 響應的呈現方式不同,在文檔頁在線調試時會逐字打印出來。

內置模型

平臺內置密鑰(DeepSeek / 月之暗面 / 火山方舟 / 阿里雲百鍊等,均可後臺擴展) 需簽名

一個 chat 端點覆蓋全部模型:換模型只改 model 參數;平臺密鑰、上遊地址、系統提示詞與採樣參數由超管在後臺維護。

POST /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)」能力已下線,傳入會返回參數值非法。
GET /api/ai/BuiltInModel/models 累計調用 0 次

模型清單

列出平臺當前可用的模型(標識、展示名、是否支持視覺、是否為默認模型)。

  • 用於讓調用方動態發現可選模型,避免把模型名寫死在客戶端。
  • 只返回模型自身信息:不含廠商、上遊地址與密鑰。
  • 請求不傳 model 時使用 is_default 為 true 的那個模型。
小影API · 通用 API 聚合服務