Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
模型 ID、支持任务、尺寸与参考图限制。
表格可横向滚动，查看完整模型 ID 与参数。
| 模型 ID | 支持任务 / 参考图 | size | aspect_ratio | n |
|---|---|---|---|---|
gemini-3.1-flash-image-preview（Nano Banana 2） | 文生图、编辑、融合 参考图 0~14 张（高保真最多 5 张） | 512、1K、2K、4K | 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9，默认 1:1 | — |
gemini-3-pro-image-preview（Nano Banana Pro） | 文生图、编辑、融合 参考图 0~14 张（高保真最多 5 张） | 1K、2K、4K | 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9，默认 1:1 | — |
gemini-2.5-flash-image（Nano Banana） | 文生图、编辑、融合 参考图 0~3 张 | 不支持 | 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9，默认 1:1 | — |
imagen-4.0-ultra-generate-001imagen-4.0-generate-001 | 文生图 | 1K、2K | 1:1、3:4、4:3、9:16、16:9 | 1~4，默认 4 |
imagen-4.0-fast-generate-001 | 文生图 | 不支持 | 1:1、3:4、4:3、9:16、16:9 | 1~4，默认 4 |
model 必须传模型 ID。
n 时默认一次生成 4 张图片。只需要 1 张时，请显式传 "n": 1。gemini-2.5-flash-image 各比例对应的输出分辨率
aspect_ratio | 输出分辨率 |
|---|---|
1:1 | 1024x1024 |
2:3 | 832x1248 |
3:2 | 1248x832 |
3:4 | 864x1184 |
4:3 | 1184x864 |
4:5 | 896x1152 |
5:4 | 1152x896 |
9:16 | 768x1344 |
16:9 | 1344x768 |
21:9 | 1536x672 |
IMAGE_RECITATION：生成因内容复述被中止，不会返回图片。建议调整 prompt 后重试。NO_IMAGE 或空结果：模型没有生成图片，可能表现为 data: []，或只返回一段文字。可按业务需要重试。{
"data": [],
"text": "[ERROR]: FinishReason.IMAGE_RECITATION"
}
{
"data": [],
"text": "好的，我来为你生成这张图片。"
}
data[].url 或 data[].b64_json 是否存在判断是否出图。参见 Google 官方 FinishReason 说明。