主体
场景
相关图像模型
根据任务类型、输出档位和参考图需求选择相邻模型。
用 Nano Banana 2.1 创作时装人像与家居场景，也可根据参考照片局部换装。在线试用并查看真实生成案例与编辑前后对照，了解提示词、画幅和分辨率选择，通过 HiAPI 接入图像生成与编辑 API。
提供商: Google
类型: 图像生成
接口: /v1/tasks
状态: 已开放
消耗: 查看页面实时价格
用 Nano Banana 2.1 创作时装人像与家居场景，也可根据参考照片局部换装。在线试用并查看真实生成案例与编辑前后对照，了解提示词、画幅和分辨率选择，通过 HiAPI 接入图像生成与编辑 API。
定价
标准用量
选择生成图片的文件格式
准备生成
配置参数并点击"运行"查看输出结果。
查看从提示词生成的图片，以及参考图与对应编辑结果。
根据任务类型、输出档位和参考图需求选择相邻模型。
用 Nano Banana 2.1 创作时装人像与家居场景，也可根据参考照片局部换装。在线试用并查看真实生成案例与编辑前后对照，了解提示词、画幅和分辨率选择，通过 HiAPI 接入图像生成与编辑 API。
本页 Playground 和 API 使用同一个模型 ID：gemini-nano-banana-2.1。只写提示词即可生成图片；添加参考图可进行编辑或参考生成，无需切换模型。
查看 Nano Banana 2.1 支持的参考图、画幅、格式与画质。
以页面实时价格与任务记录为准。
参考图负责提供事实，提示词负责分配每张图的角色并限定修改范围。
下面是可直接复制的最小请求；完整参数、回调、查询与错误码请查看 Docs。
POST /v1/tasksgemini-nano-banana-2.1curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-nano-banana-2.1",
"input": {
"prompt": "A fashion editorial photograph on a sunlit white-stucco terrace above the Mediterranean, shot at eye level with a 50mm lens. One adult woman in her late twenties is walking naturally toward the camera at the right-center of the composition, her head turned slightly toward the sea with a relaxed confident expression. She wears an oversized ivory linen blazer over a deep burgundy silk camisole, high-waisted navy tailored trousers, and simple leather sandals. Wind lifts a few strands of her dark shoulder-length hair and gently moves the blazer hem. A cobalt-blue glazed ceramic bench occupies the left foreground; beyond it, crisp ivory architecture frames a bright turquoise sea and a small distant headland. Directional late-afternoon sunlight reveals real skin texture, linen weave and silk highlights, with clean architectural shadows and controlled reflections. Rich but restrained cobalt, burgundy, ivory and warm skin tones, sophisticated magazine photography, believable proportions and hands, beautifully resolved clothing, candid physical movement, subtle film grain. The woman is the clear visual focus, with the surrounding terrace providing depth. No lettering, no logos, no watermark, no illustration, no CGI appearance, no airbrushed plastic skin.",
"resolution": "2K",
"aspect_ratio": "16:9",
"output_format": "png"
}
}'创建请求会立即返回 taskId；图像生成在后台异步完成。
从一个想法，走向一张完整作品
Nano Banana 2.1 是 Google 的图像生成与编辑模型。在 HiAPI 中，你可以从一段文字开始，把主体、场景、配色和构图组织成完整图片；也可以加入已有图片，沿着原来的视觉方向修改光线、环境或局部内容。创作与编辑使用同一个模型，无需为两种操作分别建立工作流。
本页用三张实际生成的作品展示两种摄影方向和一次参考图编辑：海岸时装人像、现代家具空间，以及原有人像的皮夹克换装。它们分别展示人物与环境怎样配合、材质怎样通过光线呈现，以及局部修改怎样延续原来的画面。点击图片可以查看完整细节，展开案例可以复制实际使用的提示词。
01 / 人物、服装与环境
时装图片需要先确定人物与场景的关系。这张海岸人像把正在行走的女性放在画面右侧，以白色拱廊、蓝色陶瓷椅和海面建立前后层次。酒红色内搭与深蓝长裤连起衣服和环境的色彩，阳光则让亚麻、皮肤和陶瓷各自呈现不同的质感。
为品牌内容或生活方式提案写提示词时，可以按主体、动作、服装、镜头和光线的顺序组织，而不是只写“高级摄影”。说明衣料、配色和身体姿态，也说明哪些物件应留在背景。成片后放大检查脸部、手部、衣服接缝与阴影；画幅明确时，还要确认主体周围有足够的版式空间。
02 / 空间、采光与材质
空间图片的细节来自物件、表面和光源之间的关系。家具案例以胡桃木扶手椅与橙色绒面坐垫作为中心，旁边的金属边桌、玻璃花瓶和浅色墙地面共同组成安静的室内场景。侧面的日光建立明暗分区，让木纹、绒面和金属反射有不同的视觉表现。
室内设计、家居品牌和家具目录可以用类似方法探索陈列方向。先选一件主角家具，再写清镜头高度、窗户位置、背景材质和少量配件；控制物件数量，能让画面的重心更容易识别。生成图适合讨论氛围与构图，产品规格、实际材料和空间尺寸仍需依据真实资料确认。
从已有作品继续创作
重新描述整张照片，容易让人物、姿态和背景一起变化。这个案例把上方海岸人像的实际输出作为参考，只要求将象牙白亚麻外套替换为酒红皮夹克，并列出脸部、发型、动作、裤子、镜头和露台等保留项。滑动对照查看外套的轮廓和材质变化，同时核对人物与环境是否延续。
连续编辑时，保存上一张结果，再将它作为下一次输入。把“修改什么”和“保留什么”分开写，能让每一轮的目标更清楚。任务之间不会自动继承对话或图片；需要延续的视觉依据，要随新任务再次提供。
使用海岸人像的实际输出，保留完整画幅。
指定外套替换，列明人物、姿态与背景保留项。
核对脸部、手部、衣料和光影，再保存结果。
1 张参考图 / 2752 × 1536
使用海岸人像的真实输出作为参考，将白色亚麻外套换成酒红皮夹克，对照查看人物、姿态与背景的延续。
Edit this exact fashion photograph. Replace only the woman's oversized ivory linen blazer with a beautifully fitted deep-burgundy soft leather jacket, worn open over the existing silk camisole. Give the jacket realistic fine leather grain, subtle natural highlights and believable folds that follow her current body and walking pose. Preserve the exact woman, face, expression, hair, skin tone, hands, body proportions, pose, navy trousers, sandals, camera framing, cobalt ceramic bench, terrace architecture, sea, sky and every background object. Maintain the existing directional sunlight and shadows; adapt only the jacket's light and reflections to its leather material. This is a garment replacement in the original photograph, not a new scene. Keep the photograph natural and editorial, with no text, no logos and no watermark.
把视觉目标写成可执行的描述
先说明画面要为谁、为哪个版位服务，再把描述分成主体、环境、镜头、光线和细节五部分。海岸案例先确定一个行走中的人物，接着描述亚麻外套、丝质内搭和深色长裤，然后安排露台、陶瓷椅与海面，最后给出镜头高度和下午阳光。这样的顺序让每个物件有明确角色，也便于根据输出定位需要修改的部分。
具体材质比笼统风格更容易指导细节：写出绒面的纤维、木材纹理、釉面反射或皮革折痕，而不只是“精美”“高级”。同时把背景物件限定到服务构图的数量。需要留白时，说明标题或产品以后会放在哪里；需要真实商品或人物一致性时，提供明确参考并逐项核对结果。
生成后先评估整体构图，再看脸部、手部、边缘与光影。只改一个明确目标时，可以把结果作为参考继续编辑；同时改动主体、环境和镜头时，则更适合重新组织完整提示词。每轮都保存输入与输出，能让创意选择与修改依据更清楚。
从要交付的素材出发，选择文字创作或参考图编辑。把视觉方向先表达清楚，再进入排版、修图或产品工作流。
品牌团队可以先用人物、服装和环境关系讨论一组视觉方向，再通过参考图编辑探索局部搭配。每次修改明确衣服、背景或光线中需要变化的部分，并核对人物特征。真实商品的颜色、剪裁和材质需与产品资料比对。
交付方向：品牌提案、生活方式配图、搭配概念
家居与设计团队可以从主角家具、材质、采光和镜头位置建立陈列场景，用图片讨论背景与产品如何配合。选择参考图继续调整时，逐项保留家具形状和空间关系，方便比较不同配色或布置方向。
交付方向：家居场景、材质氛围、空间概念
产品团队可以把原图、修改项和保留项组织成一次异步任务，为用户提供局部换装或视觉版本探索。展示结果时保留原图对照，让用户检查人物、产品和背景细节。下一轮编辑需要重新传入参考，不能依赖上一轮会话自动延续。
交付方向：参考图编辑、视觉版本提案、内容工作台
画幅决定画面怎样组织，分辨率决定输出档位。两者一起选择，能减少生成后重新裁切的工作。
在 Playground 确认画面方向后，可以用同一个 HiAPI Key、模型 ID 与输入参数接入应用。异步任务便于把生成放进内容工具、设计工作台或队列：保存任务 ID，查询状态或接收完成通知，再将图片保存到自己的存储中。页面展示当前价格，任务记录用于核对实际计费，让创作结果与调用记录能够对应。
只写提示词即可生成图片。添加参考图片后，描述需要修改的内容与必须保留的细节；两种用法使用同一个模型 ID。每次任务独立处理，需要继续编辑时再次提供上一张结果。
最多添加 10 张 JPEG、PNG 或 WebP 图片。说明每张图片提供的主体、背景或风格，再列出保留项。图片 URL 必须可以公开访问；API 单张图片不超过 30 MB。
auto 让模型根据提示词和参考图片选择画幅。需要海报或广告版位时，直接选择明确的比例；分辨率档位不代表固定的宽高像素。比例是构图目标，实际像素可能略有差异，尤其是 1:8 与 8:1；固定版位请核对输出文件尺寸后再裁切。
将需要出现的文字逐句写出，说明标题、标签和副标题的位置，并限制额外文字。成片后逐字核对，尤其是小字号与较长段落。
当前每次任务生成一张 JPG 或 PNG 图片，没有透明背景开关或批量张数参数。PNG 是文件格式，不保证透明背景。
提交后保存 taskId，通过 GET /v1/tasks/:id 查询状态，成功后读取 output[].url。也可设置 callback.url 接收终态通知；长期使用的结果请及时保存。
可以从时装人像和家居场景开始，也可以提供原图进行参考编辑。本页展示实际生成的海岸人像、家具空间与换装对照；效果取决于具体输入，交付前应检查细节。
先用 1K 判断方向；需要讨论材质、空间或版式细节时可选 2K；较大展示和后续裁切可考虑 4K。更高分辨率不会自动修正文字或结构错误，实际像素尺寸随画幅变化。
上传要编辑的原图，分别写明修改项与保留项，例如替换外套、保留人物脸部、姿态与背景。将结果与原图对照，检查衣服边缘、手部和光影；需要继续编辑时，再次提供上一张结果。
具体说明主体、动作、衣料或表面材质、镜头位置与光线方向，并控制道具数量。放大检查皮肤、手部、反射和阴影；仅写“高级摄影”或提高分辨率，不能保证细节准确。
文字生图可跳过上传；需要编辑时添加 1 至 10 张图片，说明各自的作用。
描述主体、构图和光线；编辑时写明需要修改与保留的内容，再选择画质、画幅和格式。
在 Playground 验证输入关系与结果，再用同一模型 ID 创建异步任务。