Catalog
创建前先调用:
GET /catalog
Catalog 是类型、模型和参数能力的唯一事实来源。不要在客户端写死模型、时长或分辨率。
主要字段
content_types[]:产品类型与通用限制generation_models[]:AI 生图、AI 视频可选模型及模型级能力languages[]:语言与音色visual_styles[]:支持的视觉风格
AI 视频模型会明确返回任务、比例、分辨率、时长、原生音频、附件和多轮编辑能力。当前文本生成已开放,但首帧、尾帧和附件均返回 false。
AI 生图应根据模型自己的 allowed_aspect_ratios 选择比例,不要把两个 provider 的比例集合混用。
在请求时读取 Catalog
应把 Catalog 当作运行时能力数据,而不是复制一次后写死在客户端。可用性可能随内容类型、模型、账号权益和支持的输出而不同。用返回字段构建界面选项和校验,再只发送所选类型和模型允许的值,避免客户端暴露过期的时长、音色、比例或 provider 组合。
将字段与选定产品对应
通用字段描述交付结果,但部分产品有专属控制项。duration_seconds 属于解说视频;scene_count 属于绘本视频和 AI PPT。AI 生图和 AI 视频在 OpenAPI 中分别使用嵌套的 generation 对象。不要因为字段名称相似,就把一个产品的设置带到另一个产品。
Catalog 标记为不可用的能力应直接省略,不要猜测字段。例如当前公开 AI 视频仅支持文本生成视频;只有 Catalog 明确开放时,客户端才应支持首帧、尾帧或附件。
