支持模型与参数

Yeehoo 当前对外统一通过 POST /v1/generations 创建任务，所以模型再增加，也不会新增一批新的创建接口。

后续维护重点不是给每个模型单独写一篇长文，而是把模型参数收敛成统一表格，新增模型时只补一行配置和少量备注。

统一请求骨架

所有图片和视频任务都先按这个结构理解：

{
  "model": "gpt-image-2",
  "prompt": "..."
}

怎么读这页

先看模型总览，决定用哪个模型。
再看对应模型分组表，确认必填参数、可选参数和默认值。
如果某个模型有特殊限制，只看该模型的特殊说明。

模型总览

公开模型一览

模型	类型	适用场景	推荐优先级	备注
`gpt-image-2`	图片	通用图片生成、海报、封面、编辑	高	第一优先推荐
`nano-banana-2`	图片	更快的图片生成	中	速度优先
`nano-banana-pro`	图片	更高质量图片生成与编辑	中	质量优先
`sora-2`	视频	Global 区视频生成	高	Global 区标准视频模型
`seedance-2`	视频	中国区视频生成	高	中国区标准视频模型

图片模型参数表

当前图片模型都走同一个创建接口，只是可选枚举和默认值不同。

图片模型共同字段

字段	类型	是否必填	说明
`model`	`string`	是	具体图片模型 ID
`prompt`	`string`	是	图片描述
`reference_images`	`string[]`	否	参考图 URL 列表
`aspect_ratio`	`string`	否	输出宽高比
`resolution`	`string`	否	输出分辨率
`n`	`integer`	否	生成数量

图片模型差异总表

模型	必填参数	可选参数	`aspect_ratio`	`resolution`	默认值	推荐传法
`gpt-image-2`	`model` `prompt`	`reference_images` `aspect_ratio` `resolution` `n`	`auto` `1:1` `5:4` `9:16` `21:9` `16:9` `3:2` `4:3` `4:5` `3:4` `2:3`	`1K` `2K` `4K`	`aspect_ratio=auto` `resolution=1K` `n=1`	第一版优先用它
`nano-banana-2`	`model` `prompt`	`reference_images` `aspect_ratio` `resolution` `n`	`auto` `21:9` `16:9` `3:2` `4:3` `1:1` `3:4` `2:3` `9:16`	`2K` `4K`	`aspect_ratio=auto` `resolution=2K` `n=1`	速度优先时选它
`nano-banana-pro`	`model` `prompt`	`reference_images` `aspect_ratio` `resolution` `n`	`auto` `21:9` `16:9` `3:2` `4:3` `1:1` `3:4` `2:3` `9:16`	`2K` `4K`	`aspect_ratio=auto` `resolution=2K` `n=1`	质量优先时选它

`gpt-image-2` 特殊说明

支持 5:4 和 4:5，这两个比例另外两个图片模型没有。
支持 1K，更适合先低成本跑通。
如果你不知道先选什么模型，默认先用它。

`nano-banana-2` 特殊说明

不支持 1K。
默认就从 2K 起。
适合先出图、先看效果的场景。

`nano-banana-pro` 特殊说明

参数结构和 nano-banana-2 基本一致。
更适合精修图、高质量营销图、参考图编辑。

通用图片生成

{
  "model": "gpt-image-2",
  "prompt": "A premium skincare poster on warm marble, soft daylight, luxury editorial style",
  "aspect_ratio": "4:5",
  "resolution": "2K",
  "n": 1
}

带参考图的图片编辑

{
  "model": "nano-banana-pro",
  "prompt": "Keep the bag shape, change the material to brushed metal, luxury campaign lighting",
  "reference_images": [
    "https://cdn.example.com/source/bag-front.png"
  ],
  "aspect_ratio": "1:1",
  "resolution": "4K",
  "n": 1
}

视频模型参数表

当前视频模型也统一通过 POST /v1/generations 创建，主要差别在默认值、枚举范围和参考图字段。

视频模型共同字段

字段	类型	是否必填	说明
`model`	`string`	是	具体视频模型 ID
`prompt`	`string`	是	视频描述
`first_frame_image_url`	`string`	否	首帧图片 URL
`reference_mode`	`string`	否	参考模式
`aspect_ratio`	`string`	否	输出宽高比
`resolution`	`string`	否	输出分辨率
`duration`	`integer`	否	视频时长，单位秒

视频模型差异总表

模型	必填参数	常用可选参数	`reference_mode`	`aspect_ratio`	`resolution`	默认值	推荐传法
`sora-2`	`model` `prompt`	`first_frame_image_url` `reference_mode` `aspect_ratio` `resolution` `duration`	`omni` `first_last` `multi_frame`	`21:9` `16:9` `4:3` `1:1` `3:4` `9:16`	`720P` `1080P` `4K`	`reference_mode=omni` `aspect_ratio=16:9` `resolution=1080P` `duration=5`	Global 区视频优先用它
`seedance-2`	`model` `prompt`	`reference_mode` `reference_image_url` `first_frame_image_url` `aspect_ratio` `resolution` `duration`	`omni` `first_frame`	`21:9` `16:9` `4:3` `1:1` `3:4` `9:16`	`720p` `1080p`	`reference_mode=omni` `aspect_ratio=21:9` `resolution=720p` `duration=5`	中国区视频优先用它

`sora-2` 特殊说明

当前文档里按 Global 区标准视频模型来理解。
支持 4K。
reference_mode 选项更多。

`seedance-2` 特殊说明

当前文档里按中国区标准视频模型来理解。
还支持 reference_image_url。
分辨率上限目前到 1080p。

通用视频生成

{
  "model": "sora-2",
  "prompt": "A cinematic city night drive, wet street reflections, slow camera movement",
  "aspect_ratio": "16:9",
  "resolution": "1080P",
  "duration": 5
}

中国区视频生成

{
  "model": "seedance-2",
  "prompt": "A product teaser video, clean white background, smooth motion, premium style",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

前端怎么配置才不怕后面模型变多

接口层固定：只保留统一创建接口 POST /v1/generations。
模型层表格化：每个模型只维护一行标准参数表。
特殊差异单独备注：只有真正特殊的模型，再额外补一段说明。
最好和后端 schema 绑定：后面更稳妥的方案是文档基于模型 schema 自动生成参数表，而不是手写每个模型。