小影API 小影API

AI 服務

多模型 AI 對話接口：用 model 參數在多家廠商的模型間切換，單輪 / 多輪、流式、圖片 / 視頻 / 音頻理解（部分模型）一應俱全。

/api/ai/

服務說明

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

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

同一個接口覆蓋單輪與多輪對話：傳 content 發起簡單單輪問答，傳 messages（JSON 數組，含 role 與 content）則進行多輪對話；同時支持流式輸出。

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

標記了「支持視覺」的模型可以額外傳 images（公網圖片地址）讓它看圖回答；標記了「支持視頻理解」的模型還能傳 videos（公網視頻地址，如豆包 Seed 2.0 全模態）讓它看視頻、連音軌一起理解；標記了「支持音頻理解」的模型還可以傳 audios（公網音頻地址）做語音轉寫與音頻內容理解；未標記的模型傳圖片、視頻或音頻會返回參數值非法，避免把參數靜默丟掉。

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

響應格式

所有接口返回同一個 JSON 信封，業務數據都在 data 裡： 

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}
  • code：業務狀態碼，10000 表示成功；其餘為各類錯誤，完整清單見「錯誤碼」頁。
  • msg：給人看的提示文案，可直接展示給終端用戶，但不要用它做邏輯判斷。
  • data：業務數據；出錯時通常為 null。各接口 data 的具體字段見該接口的「響應說明」。

判斷成功與否請看 code，不要依賴 HTTP 狀態碼。 查看完整錯誤碼

內置模型

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

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

POST /api/ai/BuiltInModel/chat 累計調用 0 次

AI 對話（統一入口）

用 model 選擇模型發起對話：支持單條消息、完整消息列表、系統提示詞覆蓋、圖片/視頻/音頻理解與流式輸出。

選填：不傳則使用平臺默認模型；候選清單來自平臺（見「模型清單」接口）

選填：發起簡單單輪對話時的消息內容（與 messages 至少提供一個）

選填：多輪對話用，格式為 JSON 數組，role 取 user/assistant；優先級高於 content

選填：臨時覆蓋平臺設定；不傳=用平臺按模型配置的提示詞；空字符串=不使用系統提示詞

選填：僅「支持視覺」的模型可傳；JSON 數組或純文本（換行/逗號分隔）的公網圖片地址，張數上限由平臺按模型配置（後臺可調）

選填：僅「支持視頻理解」的模型可傳（如豆包 Seed 2.0 全模態）；JSON 數組或純文本（換行/逗號分隔）的公網視頻地址，數量上限由平臺按模型配置（後臺可調）

選填：僅「支持音頻理解」的模型可傳（如豆包 Seed 2.0 全模態）；JSON 數組或純文本（換行/逗號分隔）的公網音頻地址，個數上限由平臺按模型配置（後臺可調）。音頻文件可先經「文件上傳」服務上傳，再把返回地址傳到這裡

選填：傳了就用調用方自己的 Key（須與所選模型所屬廠商一致），不傳則用平臺密鑰

選填：true 時響應為 SSE(text/event-stream)，逐塊推送

  • 請求體為 application/x-www-form-urlencoded 表單；本服務需項目簽名。
  • content 與 messages 至少提供一個，否則返回參數缺失。
  • images 僅對「支持視覺」的模型有效，其它模型傳了返回參數值非法（20003）；張數上限由平臺按模型配置（後臺可調），超限同樣返回參數值非法。
  • videos 僅對「支持視頻理解」的模型有效（如豆包 Seed 2.0 全模態，可同時理解畫面與音軌），其它模型傳了返回參數值非法（20003）；數量上限同樣由平臺按模型配置，超限返回參數值非法。
  • audios 僅對「支持音頻理解」的模型有效（如豆包 Seed 2.0 全模態，可做語音轉寫與音頻內容理解），其它模型傳了返回參數值非法（20003）；個數上限同樣由平臺按模型配置，超限返回參數值非法。
  • 採樣溫度 / 最大回復長度 / 停止詞由平臺按模型統一配置，不接受調用方傳入，傳了會返回參數值非法（20003）。
  • 流式模式返回 SSE：每幀形如 data: {"content": "片段"}（答案正文）或 data: {"reasoning": "片段"}（推理模型的思考過程，僅這類模型有，與答案分開下發、只關心答案可忽略），結束標記 data: [DONE]；在線調試會把答案正文按 Markdown 渲染排版並逐字打印，推理模型的思考過程收進可摺疊的「思考過程」（首屏自動展開，開始出答案後自動收起）。
  • 在線調用會真實消耗上遊額度，請確認平臺密鑰可用後再調試。
  • 原「前綴續寫（prefix / prefix_content）」能力已下線，傳入會返回參數值非法。
響應說明 外層統一格式

以下字段為 stream=false 時的 data 結構；stream=true 時響應改為 SSE 文本流（逐幀推送，見上方說明），不走該結構。

字段 類型 說明
reply string 模型回復正文（Markdown）
model string 對外模型標識
usage object Token 用量；上遊未返回時為 null
usage.prompt_tokens int 輸入 Token 數
usage.completion_tokens int 輸出 Token 數
usage.total_tokens int 總 Token 數
finish_reason string 結束原因；可能為 null
返回示例 
{
  "reply": "示例回复内容",
  "model": "deepseek-chat",
  "usage": {"prompt_tokens": 10, "completion_tokens": 20, "total_tokens": 30},
  "finish_reason": "stop"
}
GET /api/ai/BuiltInModel/models 累計調用 0 次

模型清單

列出平臺當前可用的模型（標識、展示名、是否支持視覺/視頻/音頻、是否為默認模型）。

  • 用於讓調用方動態發現可選模型，避免把模型名寫死在客戶端。
  • 只返回模型自身信息：不含廠商、上遊地址與密鑰。
  • 請求不傳 model 時使用 is_default 為 true 的那個模型。
響應說明 外層統一格式
字段 類型 說明
models array 可用模型列表
models[].model string 模型標識（傳參 model 的取值）
models[].name string 展示名
models[].supports_vision bool 是否支持視覺（可傳 images）
models[].supports_video bool 是否支持視頻理解（可傳 videos）
models[].supports_audio bool 是否支持音頻理解（可傳 audios）
models[].context_window int 上下文長度；未知為 null
models[].is_default bool 是否為默認模型
返回示例 
{
  "models": [
    {"model": "deepseek-chat", "name": "DeepSeek Chat", "supports_vision": false,
     "supports_video": false, "supports_audio": false, "context_window": 65536,
     "is_default": true}
  ]
}
小影API · 通用 API 聚合服務