能力目录
每次创建前调用:
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 中的链接描述成已经读取的网页。
使用建议
- 创建表单每次打开时读取一次。
- 缓存时设置合理过期时间,并允许手动刷新。
- 账号或套餐变化后重新读取。
- 只展示当前响应里出现的选项。
- 未返回的能力视为不可用,不要猜测。
