能力目錄
每次創建前調用:
GET /capabilities
能力目錄接口會根據當前賬號返回可用產品、文件限制、視頻模板與音色、圖片模型與質量等信息。客戶端應使用這些數據構建選項和校驗,不要長期寫死。
頂層內容
| 字段 | 說明 |
|---|---|
| 產品 | 當前公開產品,現為 video、image、app |
| 賬戶 | 當前套餐的安全摘要 |
| 文件 | 支持的文件類型、大小和數量 |
| 視頻 | 解說視頻參數 |
| image | AI 生圖模型組合 |
| 應用 | AI 應用參數 |
解說視頻
video 中會返回:
- duration_presets:可選時長目標和對應區間
- aspect_ratios:當前固定為 16:9
- languages:語言
- templates:當前可選場景模板
- expression_styles:獨立表達風格
- supports_files、supports_url_context 和 supports_messages
模板和表達風格是兩個獨立選擇。模板幫助確定場景主題和內容結構,表達風格決定畫面表達。請分別發送 template_id 與 expression_style_id。
AI 生圖
image.models 中的每一項都是一個完整模型組合。當前包括:
- 基米尼 + 納米 - 香蕉2
- azure_openai + gpt-image 2 圖像
每個組合會返回自己的 aspect_ratios、output_qualities 和 qualities。provider 與 model 必須來自同一項,不得把一個組合的比例或質量用於另一個組合。
其中:
- output_quality 表示最終輸出規格。
- quality 是 GPT Image 的原生質量檔位,只能用於 azure_openai + gpt-image-2。
AI 應用
app 會返回支持的語言,以及 supports_files 等能力。AI 應用支持上傳附件,但當前不聲明 URL Context;不要把 prompt 中的鏈接描述成已經讀取的網頁。
使用建議
- 創建表單每次打開時讀取一次。
- 緩存時設置合理過期時間,並允許手動刷新。
- 賬號或套餐變化後重新讀取。
- 只展示當前響應裡出現的選項。
- 未返回的能力視為不可用,不要猜測。
