サイズと解像度

アスペクト比と解像度は、次のように 2 つのパラメータへ分けることを推奨します。

{
  "size": "16:9",
  "resolution": "2k"
}

具体的なピクセル数を直接指定することもできます。

{
  "size": "3840x2160"
}

推奨オプション

resolution のみを使用することを推奨します。次のフィールドにも対応しています。

フィールド	例	説明
`resolution`	`1k` / `2k` / `4k`	推奨フィールド。
`image_size`	`2k`	互換用エイリアス。
`scale`	`4k`	互換用エイリアス。
`upscale`	`2k` / `4k`	互換用エイリアス。
`quality`	`2k` / `4k`	旧形式との互換用。解像度を表す目的での使用は推奨しません。

size がアスペクト比の場合、サービスは具体的なピクセル数に変換します。幅と高さは 16 ピクセル単位にそろえられます。4K プランは約 3840x2160 のピクセル予算内に収まるよう調整されるため、正方形の 4K は 3840x3840 ではなく 2880x2880 です。

`size`	1K	2K	4K
`auto` / `1:1`	`1024x1024`	`2048x2048`	`2880x2880`
`3:2`	`1008x672`	`2016x1344`	`3504x2336`
`2:3`	`672x1008`	`1344x2016`	`2336x3504`
`4:3`	`1024x768`	`2048x1536`	`3264x2448`
`3:4`	`768x1024`	`1536x2048`	`2448x3264`
`5:4`	`960x768`	`2000x1600`	`3200x2560`
`4:5`	`768x960`	`1600x2000`	`2560x3200`
`16:9`	`1024x576`	`2048x1152`	`3840x2160`
`9:16`	`576x1024`	`1152x2048`	`2160x3840`
`2:1`	`1024x512`	`2048x1024`	`3840x1920`
`1:2`	`512x1024`	`1024x2048`	`1920x3840`
`21:9`	`1008x432`	`2016x864`	`3696x1584`
`9:21`	`432x1008`	`864x2016`	`1584x3696`

n の上限はプランによって異なります。