Nano Banana Pro
nano-banana-pro
基于 Gemini 3 Pro 推理骨干的质量优先图像生成与编辑模型,强于多图角色一致性与文字渲染,支持 2K 原生输出并智能放大至 4K
试用 nano-banana-pro
输入
作品灵感
查看全部作品输出
image价格
nano-banana-pro 每张
| 规格 | 单价 |
|---|---|
| 1K | $0.057 |
| 2K | $0.057 |
| 4K | $0.100 |
定位简介
nano-banana-pro 是 Google 推出的图像生成与编辑模型,同时支持文生图和图生图两条路径。它面向质量优先的创作任务,在画面构图、多图角色一致性和文字渲染上表现更稳,并支持 1K 至 4K 输出与多种画幅比例。适合需要系列化视觉产出的设计师、电商与品牌内容团队,以及把图像生成能力接入产品流程的开发者。
核心亮点
- 最高 4K 分辨率输出——可在 1K、2K、4K 三档间选择输出分辨率,满足从快速预览到高清成图的完整链路。
- 最多 8 张参考图输入——图生图时可传入多张参考图,用于跨图保持角色与风格一致,适合系列化内容生产。
- 构图与文字渲染更可控——基于推理能力解析提示语义与空间关系,在排版类、带文字的海报与封面任务中成图更可用。
- 画幅与格式参数可调——支持 11 种画幅比例与 png、jpg 两种输出格式,便于直接对接不同渠道的素材规格。
能力说明
文生图与图生图一体:同一模型既可根据文本提示生成新图,也可对输入图片按提示进行编辑变换,减少在多个模型间切换的成本。
多参考图一致性:最多可传 8 张参考图,让模型在系列图像中维持角色与视觉风格,适合需要成套产出的内容项目。
分辨率与画幅控制:输出可选 1K、2K、4K,并支持 1:1 到 21:9 共 11 种比例与 auto 自动选择,直接产出符合投放位规格的素材。
语义与构图推理:生成前对提示中的对象关系与空间布局进行解析,复杂描述下的构图稳定性更高,减少反复重试。
适用场景
- 品牌与社交媒体内容团队:活动主题文案——批量产出统一风格的系列海报与社媒配图,凭借多参考图一致性保持角色和视觉语言不漂移。
- 电商与广告设计:产品图与创意 brief——以图生图方式在保留产品主体的情况下替换场景与风格,产出可直接用于详情页和广告位的成图。
- 游戏与影视前期:角色设定与故事板——用多张参考图锁定角色特征,生成跨镜头一致的概念图与分镜,用于团队内部评审与迭代。
- 出版与平面设计:封面、海报文字排版——依靠文字渲染与构图控制能力生成含标题文字的封面和海报初稿,减少后期返工。
限制与选型建议
该模型定位质量优先,生成过程包含较重的推理环节,出图速度慢于偏重吞吐的轻量模型,不适合需要毫秒级响应或大批量快速试错的场景。角色一致性与文字渲染效果依赖提示词与具体画面,并非绝对保证,复杂排版建议先小批量验证。它只负责图像生成与编辑,不承担通用对话或文本任务。若首要目标是低成本高频迭代,可考虑同族中更轻量的型号。
常见问题
查看全部常见问题 →-
Nano Banana Pro 主要适合什么任务?
生成高细节商业图片,或结合可选参考图进行重绘,支持丰富画幅与最高 4K 输出。
-
Nano Banana Pro 是否支持参考图?
支持最多 8 张可选参考图;不上传时可作为纯文生图使用。
-
支持哪些输出规格?
当前页面展示 1K、2K、4K 与 auto、1:1、16:9、9:16、3:4、4:3、3:2、2:3、5:4、4:5、21:9;最终可选项以 Playground 参数为准。
-
Nano Banana Pro 如何计费?
按成功生成的图片数量计费;不同分辨率或质量档如有差异,会在页面实时价格中显示。
提交生成任务
https://api.hiapi.ai/v1/tasks 请求头
Authorizationstring必填账号 API Key,所有请求必填。示例:Bearer YOUR_HIAPI_API_KEY。获取 API Key
Content-Typestring可选请求体固定按 JSON 解析;如携带,仅接受 application/json(可带 charset),其他取值返回 415。示例:application/json。
Idempotency-Keystring可选幂等键,最长 255 字节。同账户同键的重试只创建一次任务,重放返回首次 taskId。
网络超时或客户端自动重试时,同键只创建一次任务、不会重复扣费(幂等范围 = API Key 所属账户)。建议用业务侧唯一标识做键(如 "order-42");同键重放返回首次 taskId,键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。
请求体
modelstring必填当前固定值:nano-banana-pro
routestring可选当前固定值:default
inputobject必填
nano-banana-pro 和线路 default 的业务参数对象,见下方参数表。
promptstring必填minLength 1maxLength 20000描述期望生成或编辑的图像内容的文本提示词,字符串形式,最大长度 20000 字符。
resolutionstring可选默认值: "1K"控制输出图像的分辨率,字符串形式,默认 1K。
1K2K4Kimage_inputarray可选maxItems 8可选的参考图像 URL 数组,元素为图像链接,最多 8 张,支持 image/jpeg、image/png、image/webp 格式,单张文件最大 30MB。
Array [ string ]
aspect_ratiostring可选默认值: "auto"控制输出图像的宽高比,字符串形式,默认 auto。
auto1:116:99:163:44:33:22:3显示全部(3 项)
5:44:521:9output_formatstring可选默认值: "png"控制输出图像的格式,字符串形式,默认 png。
pngjpgcallbackobject可选
终态通知配置;为空则不回调,由调用方自行查询。详见下方回调说明。
创建任务时提供 callback.url,任务终态时 HiAPI 主动 POST 通知你的服务,可免去轮询。回调请求体与任务详情数据结构同构;签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。
urlstring必填callback 存在时必填;任务终态后向该 URL 发起 POST,须为合法 http(s) URL。
whenstring可选默认值: "final"当前仅支持 final,即 success / fail 均回调。
finalstoragestring可选默认值: "temp"产物存储档位:temp(默认,保留约 7 天)或 persistent(长期保存,按大小计费)。余额不足或超出存储上限会静默降级为 temp;实际生效档位见任务详情响应。
temppersistent请求示例
# 提交异步任务,成功立即返回 taskId(不等待生成完成)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"input": {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "nano-banana-pro",
input: {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "nano-banana-pro",
"input": {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} 获取任务详情
https://api.hiapi.ai/v1/tasks/:id 响应字段
taskIdstring必填任务 ID,前缀固定 tk-hiapi-。
modelstring必填解析后的模型全名。用 route 参数提交的任务返回 base@线路(如 gpt-image-2/text-to-image@ext);否则与创建时传入的模型名一致。
routestring可选仅当任务用显式 route 参数提交时出现,回显提交时的原值。
statusstring必填任务状态。
queued 已入队,尚未开始。
handling 处理中。
archiving 处理完成,产物准备中。
success 终态:完成,产物可用(返回 output)。
fail 终态:失败(返回 error)。
提交后按 status 判断:success 或 fail 为终态,其余为非终态,建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物,并在 expireAt 前完成下载或转存;需要长期保留时在创建任务时使用 storage: "persistent"。
creatednumber必填任务创建时间(Unix 秒)。
completednumber必填进入终态的 Unix 秒;非终态固定为 0。
outputarray可选
仅 status == success 时出现。产物列表,始终为数组,同一任务可能同时返回多个 type(如 video + first_frame)。
Array [ object ]
数组元素
urlstring必填资源 URL,可直接下载。
typestring必填当前可能值:video、image、audio、first_frame、last_frame、thumbnail,后续可能会扩展。
expireAtnumber必填资源可访问截止时间(Unix 秒);过期前请完成下载或转存。
errorobject可选
仅 status == fail 时出现。
codestring必填业务错误码。
messagestring必填错误描述。
响应示例
成功
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} 处理中(非终态)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} 失败
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} 相关文章
查看全部文章 →相关模型
查看全部模型 →同类型模型
-
FIBO 1.5 Bria $0.058 /张 -
Grok Imagine Quality xAI $0.070 /张 -
Krea 3 Krea $0.036 /张 -
Grok Imagine xAI $0.011 /秒 -
Qwen Image 2.1 Alibaba $0.020 /张 -
Qwen Image 2.0 Alibaba $0.042 /张 -
Nano Banana 2 Google $0.036 /张 -
FLUX 1.1 Pro Black Forest Labs $0.050 /张 -
Imagen 4 Google $0.030 /张 -
FLUX.1 Fill Pro Black Forest Labs $0.071 /张 -
Nano Banana 2 Lite Google $0.033 /张 -
Ideogram V3 Character Ideogram $0.090 /张
同厂商模型
-
Gemini Omni 1.1 Flash Google $0.450 /条 -
Veo 3.1 Fast Google $0.170 /秒 -
Nano Banana Google $0.021 /张 -
Lyria 3 Pro Google $0.140 /首 -
Veo 3.1 Google $0.290 /秒 -
Imagen 4 Google $0.030 /张 -
Gemini Omni Google -- -
Nano Banana 2 Google $0.036 /张 -
Google Virtual Try-On Google $0.107 /张 -
Gemini 3.1 Flash TTS Google -- -
Veo 3.1 Lite Google $0.060 /秒 -
Lyria 3.5 Google $0.090 /首










