概览/OpenAPI/能力目录

能力目录

获取当前账号可用的产品、参数、模板和模型。

能力目录

每次创建前调用:

GET /capabilities

能力目录接口会根据当前账号返回可用产品、文件限制、视频模板与音色、图片模型与质量等信息。客户端应使用这些数据构建选项和校验,不要长期写死。

顶层内容

字段 说明
products 当前公开产品,现为 video、image、app
account 当前套餐的安全摘要
files 支持的文件类型、大小和数量
video 解说视频参数
image AI 生图模型组合
app 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 中的每一项都是一个完整模型组合。当前包括:

  • gemini + nano-banana-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 中的链接描述成已经读取的网页。

使用建议

  • 创建表单每次打开时读取一次。
  • 缓存时设置合理过期时间,并允许手动刷新。
  • 账号或套餐变化后重新读取。
  • 只展示当前响应里出现的选项。
  • 未返回的能力视为不可用,不要猜测。