概覽/OpenAPI/能力目錄

能力目錄

獲取當前賬號可用的產品、參數、模板和模型。

能力目錄

每次創建前調用:

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 中的鏈接描述成已經讀取的網頁。

使用建議

  • 創建表單每次打開時讀取一次。
  • 緩存時設置合理過期時間,並允許手動刷新。
  • 賬號或套餐變化後重新讀取。
  • 只展示當前響應裡出現的選項。
  • 未返回的能力視為不可用,不要猜測。