使用指南
Nano Banana 基础版文生图指南:画幅、留白与提示词用法
用任务接口的 aspect_ratio 与 prompt 字段,为横幅与社交卡片生成构图明确的图像
本页内容
这条线路的定位与边界
nano-banana 在 HiAPI 上是一条文生图(text-to-image)线路,以异步任务的方式提交:请求体中的输入字段统一挂在 input 对象下,提交后按任务方式取回结果。它适合有批量配图需求的场景,例如运营横幅、社交卡片、文章配图底稿。本文只讨论基础版,不涉及同系列的其它型号。
可用字段很少,因此先把契约说清楚:prompt 为必填字符串,长度 1–5000 字符;aspect_ratio 可选,默认 auto,枚举为 auto、1:1、16:9、9:16、3:4、4:3、3:2、2:3、5:4、4:5、21:9;output_format 可选 png 或 jpeg,默认 png。旧字段 image_size 已废弃,指定目标画幅请改用 aspect_ratio。
需要明确的是,本线路未暴露 resolution、quality、width、height、seed 以及参考图上传等字段。不要按其它图像模型的习惯往 input 里塞这些键,也不要假定它们会被静默忽略。同样,aspect_ratio 用于指定目标画幅比例,不承诺固定的像素尺寸;实际画幅与像素请以返回图片为准,交付前需检查。

字段契约与一个最小 input 片段
下面是一个仅包含上述字段的 input 片段,用于说明字段层级。它不是完整的 HTTP 请求:没有给出 endpoint、鉴权头与任务轮询方式,这些请以 HiAPI 的接口文档为准。
{
"input": {
"prompt": "横向构图的扁平几何插画,暖沙色背景,右侧三分之一为阶梯状色块,左侧留白,画面无文字。",
"aspect_ratio": "16:9",
"output_format": "png"
}
}
prompt 的写法会影响画面的可控程度。一个实用的顺序是:先写主体与场景,再写构图与主体位置,然后写留白区域,最后写色彩、光线与风格。若画面中不需要文字,明确写“画面中不出现任何文字、字母与数字”,比事后修图更省事。长度上不必贴满 5000 字符,把关键约束写清楚即可;过长的堆叠反而会让重点互相稀释。
output_format 的选择按交付链路来定:png 适合无损保存与后续编辑,jpeg 适合有损压缩的交付。默认是 png,如果下游对体积敏感,记得显式改为 jpeg。需要说明的是,能选择 png 并不代表模型生成了 alpha 透明通道;本线路没有透明背景的能力声明或字段,不承诺去底或透明输出。
画幅与留白:先定版式,再写提示词
留白不是“空着”,而是为标题、按钮、角标预留的位置。不同画幅的留白策略不同,写提示词时应把留白当作构图的一部分描述出来。
- 16:9 横幅:常见于站点头图与文章封面。建议把主体偏置到右侧或左侧三分之一,另一侧留出连续的低信息区域,避免主体压住标题。提示词里可写“画面左侧保留约三分之一宽度的低对比留白区域”。
- 1:1 社交卡片:主体居中,上下各留一圈呼吸空间;四周元素不要贴边,避免在信息流裁切时被切掉。
- 9:16 竖版:顶部与底部各留出一条带状区域,供标题与署名使用;主体放在中段,避免与两端文字区重叠。
- 4:5 与 3:4:接近印刷与信息流的常见比例,留白可以少一些,但仍建议保留四周安全边距。
- 21:9 超宽:横向空间充裕,适合把多个元素排成节奏,但两端容易被裁切,重要主体不要贴边。
- auto:由服务端决定比例,适合早期探索;一旦进入批量生产,建议显式指定比例,减少版式返工。
需要再次强调:比例不等于像素。aspect_ratio 设定的是目标画幅比例,16:9 不代表固定像素尺寸(如 1920×1080)。拿到图像后应检查实际画幅是否符合预期;若下游有硬性尺寸要求,再自行缩放或裁切,并在提示词阶段就把安全边距留足。
两个可直接改写的提示词实例
以下两段是待验证的写法,不是实测结论。建议先各调用一次,观察主体位置与留白是否符合预期,再按项目调整。
横幅留白(16:9):
“横向构图的扁平几何插画,暖沙色背景。画面右侧三分之一放置一组由赤陶色、赭色与深棕色方块组成的阶梯状结构,自左向右逐级下降,边缘干净;画面左侧三分之二保持低对比、无细节的留白区域,仅保留极淡的横向色带作为过渡。整体色调克制,无渐变噪点,无文字、字母、数字与标识,构图平衡,适合作为文章头图。”
社交卡片(1:1):
“正方形构图的极简插画,浅米色背景。画面中央放置一个由三条弧线交叠而成的抽象标记,颜色为深墨绿与赭石,线条粗细均匀;标记四周保留均匀的留白,上下留白略大于左右,便于后续叠加标题。背景纯净,无纹理、无阴影、无文字、字母、数字与标识,整体安静、克制。”
两段提示词都把“留白”写成了可执行的空间描述,而不是一句“留白多一点”。如果一次生成的主体仍然贴边,优先调整描述中的方位词与占比,而不是不断加形容词。
逐步迭代:一次只改一个变量
批量出图最容易犯的错误,是一次性改 prompt、比例和格式,然后无法判断哪一处导致了变化。更稳的做法是分步收敛。
- 第一步,固定 aspect_ratio 与 output_format,用一句短提示词确认主体是否被正确理解。
- 第二步,加入构图描述:主体位置、占画面比例、留白区域。
- 第三步,补充色彩、光线与风格,观察是否挤压留白。
- 第四步,把稳定下来的描述整理成模板,批量时只替换主体与配色,不再改动结构句。
每次调用后记录 prompt、aspect_ratio、output_format 与结果的差异。记录本身就是资产:当同一批任务出现系统性偏移时,可以从记录里快速定位是比例选错、提示词结构变化,还是字段拼写问题。
交付自检与失败处理
拿到图像后,按下面几项自检:画幅是否符合 aspect_ratio 的目标比例;主体是否完整、未被裁切;预留的文字区是否足够干净;画面中是否出现了不需要的文字或水印状元素;输出格式是否符合下游要求。若用于横幅,还要在实际页面尺寸下预览一次,确认标题叠加后不压主体。
任务失败或结果偏离时,按顺序排查:prompt 是否为空或超出 1–5000 字符;aspect_ratio 是否在枚举值内;output_format 是否只用了 png 或 jpeg;是否误用了已废弃的 image_size;是否传入了本线路未暴露的字段。确认参数无误后,再简化提示词重试,而不是用同一份输入反复提交。若连续多次偏离,先把画面元素减到最少,再逐项加回。
最后提醒:文中插图仅为概念示意,用于说明“输入经任务通道得到图像”的流程,不是 nano-banana 的真实输出。所有提示词与字段组合都建议先自行调用验证,再进入生产流程。模型详情见 /models/nano-banana。