概览/OpenAPI/Catalog

Catalog

读取产品、模型、限制、语言、音色与风格。

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 明确开放时,客户端才应支持首帧、尾帧或附件。

关联文档