模式: Text to Image
产品实拍
将同一产品放入多种场景，用于广告、列表与社交帖。
Nano Banana 2.1 API。4K 图片，按张计价。
通过 Topview API 将 Nano Banana 2.1 图像生成与编辑接入产品。以 14 种宽高比创建 1K、2K 或 4K 图片，最多用 14 张输入图编辑；提供透明按张定价、即用 Playground 与开发者文档。
低于官方费率1K · 2K · 4K14 种宽高比最多 14 张图编辑
免费试用 Nano Banana 2.1 API
设置
Text to Image · 1k
此处设置为预览。Generate 会复制提示词并打开对应的 Platform Playground，请在那里确认最终设置。
示例与提示词
看看 Nano Banana 2.1 API 能做什么
真实 Nano Banana 2.1 输出与对应提示词。复制提示词并在 Playground 中测试。
模式: Text to Image
海报与信息图
生成标题与标签更清晰的海报与信息图，服务活动版式。
模式: Text to Image
角色系列
在漫画、活动或分镜序列中保持同一角色。
模式: Text to Image
视频缩略图
以自有视频为参考，制作与内容匹配的缩略图与封面。
模型规格
接入前先了解关键设置。
Topview API Platform 文档中 Nano Banana 2.1 设置的快速参考。各模式有各自的输入要求。
| 参数 | 取值 |
|---|---|
| 提供方 / 模型 | Google / Nano Banana 2.1 |
| API 路由 | google/nano-banana-2.1 |
| 生成模式 | Text to Image · Image Editing |
| 分辨率 | 1K · 2K · 4K（默认 1K） |
| 宽高比 | 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 |
| Image Editing 输入 | 1–14 images |
| 提示词长度 | 最多 10,000 字符 |
| 任务模式 | 异步提交 + 轮询 + 获取输出 |
| 价格 | 按生成图片计费；按实际用量结算 |
开发者快速开始
从 API key 到第一张图片。
用 Platform API key 提交异步 prediction，再轮询返回的任务 ID 以获取输出。
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana-2.1/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"resolution": "1k",
"aspect_ratio": "1:1"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"示例与 Platform 文档中的 Nano Banana 2.1 文生图请求一致。请仅在服务器端保存 TOPVIEW_API_PLATFORM_KEY。
步骤 1
获取 API key
登录 Topview API Platform，创建具备所需模型权限的 API key。请妥善保管密钥，并用它认证 API 请求。
步骤 2
生成或编辑图片
提交文本提示词，或上传用于编辑的参考图。配置支持的图片设置，发送 API 请求，并保存返回的任务 ID。
步骤 3
获取图片
检查任务状态直至生成完成。获取图片 URL，核对最终用量费用，并保存生成的图片。
面向生产工作流
构建灵活、偏重参考图的图像工作流
Nano Banana 2.1 支持高分辨率素材、非常规宽高比与多图编辑，适合需要不止一张源照片的创意系统。
多图产品合成
在编辑请求中组合多张产品、场景与造型图，打造更丰富的电商视觉与活动构图。
跨版式活动素材
利用 14 种宽高比（含横幅友好格式）创建方形、竖版、横版与超宽画面。
4K 品牌与编辑视觉
为高细节创意概念、营销版式与视觉内容制作生成或编辑 1K、2K 或 4K 图片。
基于参考的设计流程
构建可接受最多 14 张源图的图像编辑工具，用于引导构图、视觉更新与创意探索。
为什么选择 TOPVIEW API
在一个 API 中获得更多参考输入与输出尺寸
在产品落地前，用 Topview 探索 Nano Banana 2.1 更广的图像输入与格式选项。
试用最多 14 张编辑输入
在 Playground 测试真实源图组合，集成时遵循 Image Editing schema。
按输出分辨率定价
分别比较 1K、2K、4K 的按张费率，而不是假定一种价格适用所有配置。
预览非常规宽高比
验证全部 14 种比例，覆盖宽横幅、社交版位与特殊创意格式。
在同一工作区使用图像模型
无需单独开设其他提供商账户，即可对比 Nano Banana 2.1、Nano Banana 2 等图像 API。
Nano Banana 2.1 API 常见问题
你可以打开 Nano Banana 2.1 Playground 查看设置。API 用量从 Platform 美元余额扣费，促销积分会随时间变化。请在 Topview API Platform 查看当前工作区资格与余额。
Topview API Platform 列出 Text to Image 与 Image Editing。Image Editing 接受 1–14 张输入图及提示词。
Nano Banana 2.1 可输出 1K、2K 或 4K，并支持 14 种宽高比，从 1:1、16:9 到 1:8、8:1 等极端格式。价格取决于分辨率。
每张生成图按对应分辨率费率计费，目前 Text to Image 与 Image Editing 费率相同。提交会预留资金，请在已完成任务上读取 charged_usd 作为最终费用。
创建 Platform API key，使用 Idempotency-Key 向 Nano Banana 2.1 端点提交 prediction，保存返回的任务 ID 并轮询至完成。请尽快下载图片，因为结果 URL 可能过期。密钥请保留在服务器端。
下一张图片从这里开始
用 Nano Banana 2.1 API 构建
在 Playground 试用第一条提示词，对比当前价格，或按文档将 Nano Banana 2.1 集成到应用。